@staix/agent-hub 0.12.26 → 0.12.27

package/docs/verified.json

@@ -2,7 +2,7 @@
   "schemaVersion": 1,
   "documents": {
     "README.md": {
-      "verifiedAgainst": "fbf96c0804f823282de4e3c4c19f16d94b725e57",
+      "verifiedAgainst": "59dd48030a3272d984a738017d22bcecc66217e6",
       "paths": [
         "package.json",
         "src/",
@@ -11,14 +11,14 @@
       ]
     },
     "docs/security.md": {
-      "verifiedAgainst": "fbf96c0804f823282de4e3c4c19f16d94b725e57",
+      "verifiedAgainst": "59dd48030a3272d984a738017d22bcecc66217e6",
       "paths": [
         "src/",
         "templates/"
       ]
     },
     "docs/operations.md": {
-      "verifiedAgainst": "fbf96c0804f823282de4e3c4c19f16d94b725e57",
+      "verifiedAgainst": "59dd48030a3272d984a738017d22bcecc66217e6",
       "paths": [
         "package.json",
         "src/",
@@ -35,7 +35,7 @@
       ]
     },
     "docs/quickstart.md": {
-      "verifiedAgainst": "fbf96c0804f823282de4e3c4c19f16d94b725e57",
+      "verifiedAgainst": "59dd48030a3272d984a738017d22bcecc66217e6",
       "paths": [
         "package.json",
         "src/",
@@ -43,7 +43,7 @@
       ]
     },
     "docs/agent-notes/adapters.md": {
-      "verifiedAgainst": "fbf96c0804f823282de4e3c4c19f16d94b725e57",
+      "verifiedAgainst": "59dd48030a3272d984a738017d22bcecc66217e6",
       "paths": [
         "src/adapters/",
         "src/pi/",
@@ -98,7 +98,7 @@
       ]
     },
     "docs/agent-notes/daemon.md": {
-      "verifiedAgainst": "fbf96c0804f823282de4e3c4c19f16d94b725e57",
+      "verifiedAgainst": "59dd48030a3272d984a738017d22bcecc66217e6",
       "paths": [
         "src/hub/daemon.ts",
         "src/hub/control-client.ts",
@@ -155,7 +155,7 @@
       ]
     },
     "docs/agent-notes/tasks.md": {
-      "verifiedAgainst": "d093a5a81b341a3ae1c777154a41497aeaf1899d",
+      "verifiedAgainst": "59dd48030a3272d984a738017d22bcecc66217e6",
       "paths": [
         "src/hub/tasks.ts",
         "src/hub/board.ts",
@@ -172,7 +172,7 @@
       ]
     },
     "docs/agent-notes/tests.md": {
-      "verifiedAgainst": "fbf96c0804f823282de4e3c4c19f16d94b725e57",
+      "verifiedAgainst": "59dd48030a3272d984a738017d22bcecc66217e6",
       "paths": [
         "test/",
         "scripts/check.sh",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@staix/agent-hub",
-  "version": "0.12.26",
+  "version": "0.12.27",
   "description": "Native multi-agent hub: Claude Code, Codex, Kimi Code, Pi and local inference as peers in one project",
   "license": "MIT",
   "type": "module",
@@ -24,6 +24,8 @@
   "files": [
     ".claude-plugin",
     "src",
+    "src/pet/window.jxa.js",
+    "src/pet/window.html",
     "plugins",
     "templates",
     "scripts/check-docs.mjs",

package/plugins/agent-hub/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-hub",
-  "version": "0.12.26",
+  "version": "0.12.27",
   "description": "Channel between Claude Code and the agent-hub daemon: peer messages from Codex, Kimi and the local worker arrive as channel events; hub_send replies.",
   "author": {
     "name": "Young Joon Lee",

package/plugins/agent-hub/server.js

@@ -16157,7 +16157,7 @@ import { join as join4 } from "path";
 // package.json
 var package_default = {
   name: "@staix/agent-hub",
-  version: "0.12.26",
+  version: "0.12.27",
   description: "Native multi-agent hub: Claude Code, Codex, Kimi Code, Pi and local inference as peers in one project",
   license: "MIT",
   type: "module",
@@ -16181,6 +16181,8 @@ var package_default = {
   files: [
     ".claude-plugin",
     "src",
+    "src/pet/window.jxa.js",
+    "src/pet/window.html",
     "plugins",
     "templates",
     "scripts/check-docs.mjs",

package/src/cli/help.ts

@@ -18,6 +18,7 @@ const SECTIONS: [string, [usage: string, description: string][]][] = [
     ["ahub up [--unattended] [--no-console]", "start the daemon; interactive terminals enter console"],
     ["ahub console [--panels] [--color=auto|always|never]", "enter the human console; P cycles built-in pet characters/off; exiting leaves the daemon running"],
     ["ahub console --no-pet", "turn off attention for this session; combines with --panels and --color"],
+    ["ahub pet --window [--close]", "start or close the macOS floating window, from a person's terminal"],
     ["ahub pet [--short]", "read attention without connecting; --short prints ahub!N only when action is needed"],
     ["ahub sdlc status [task] | explain <task> | export <task> | record <task> <receipt-json>", "read head-bound lifecycle gates and the next actor/action (person only)"],
     ["ahub sdlc queue <owner/repo> | release <owner/repo> [live-issue...]", "read-only merge and release evidence (person only)"],

package/src/cli/identity.ts

@@ -28,6 +28,7 @@ export type PeerCommandAccess = "allowed" | "conductor" | "console";
 
 /** A closed list: unknown commands cannot acquire console authority through an agent shell. */
 export function classifyPeerCommand(command: string, args: readonly string[]): PeerCommandAccess {
+  if (command === "pet" && args.includes("--window")) return "console";
   if (command === "permission" || command === "stop" || command === "watch") return "console";
   if (args.some((arg) => arg === "--as-user" || arg.startsWith("--as-user="))) return "console";
   if (command === "role") return ["list", "show"].includes(args[0] ?? "") ? "allowed" : "console";

package/src/cli/main.ts

@@ -5,7 +5,8 @@ import { projectedDiff } from "../hub/projected-diff.ts";
 import { TextProjections } from "../hub/text-projection.ts";
 import { terminalText } from "./console-state.ts";
 import { petView, readPet, renderPet } from "./pet.ts";
-import { loadPetConfig } from "./pet-config.ts";
+import { startPetWindow, closePetWindow } from "../pet/window.ts";
+import { loadPetConfig, savePetPalette } from "./pet-config.ts";
 import { profileName, projectProfile, resolveProfile } from "../hub/profiles.ts";
 import { catalogAssignments, loadRoleCatalog, selectedRoles } from "../hub/roles.ts";
 import { attachWatch } from "./watch.ts";
@@ -677,6 +678,8 @@ const commands: Record<string, () => Promise<void> | void> = {
     if (unattended) console.error(UNATTENDED_WARNING);
     const status = await startProject(registeredProject(), { unattended });
     console.log(`ahub up (ws://127.0.0.1:${status.controlPort}), state in ${stateDir}`);
+    try { if (loadPetConfig(cwd).window) console.log(await startPetWindow(stateDir, cwd)); }
+    catch { console.error("Pet window was not started; run ahub pet --window to inspect it."); }
     if (process.stdin.isTTY && process.stdout.isTTY && !args.includes("--no-console")) await runConsole({ client: await connect(), cwd, stateDir });
   },
 
@@ -1359,8 +1362,17 @@ const commands: Record<string, () => Promise<void> | void> = {
     hub.close();
   },
 
-  pet: () => {
-    if (args.some(arg => arg !== "--short")) return fail("usage: ahub pet [--short]");
+  pet: async () => {
+    if (args.includes("--window")) {
+      if (args.some(arg => !["--window", "--close"].includes(arg))) return fail("usage: ahub pet --window [--close]");
+      return console.log(await (args.includes("--close") ? closePetWindow(stateDir) : startPetWindow(stateDir, cwd)));
+    }
+    if (args.includes("--palette")) {
+      if (args.length !== 2 || args[0] !== "--palette") return fail("usage: ahub pet [--short] | --window [--close] | --palette <blue|teal|violet|ochre>");
+      try { return console.log(savePetPalette(cwd, args[1]!)); }
+      catch (error) { return fail((error as Error).message); }
+    }
+    if (args.some(arg => arg !== "--short")) return fail("usage: ahub pet [--short] | --window [--close] | --palette <blue|teal|violet|ochre>");
     const short = args.includes("--short");
     let character: import("../pet/frame.ts").CharacterId | undefined;
     try { character = loadPetConfig(cwd).character; } catch { /* explicit structural reads remain available with malformed presentation config */ }

package/src/cli/pet-config.ts

@@ -1 +1 @@
-export { loadPetConfig, type PetConfig } from "../pet/config.ts";
+export { loadPetConfig, savePetPalette, type PetConfig } from "../pet/config.ts";

package/src/hub/ui.ts

@@ -6,8 +6,6 @@ import { PEER_START_RETRY_MS } from "./start-mode.ts";
 import { taskProgress } from "../ui/task-progress.ts";
 import { officeModel } from "../ui/office-model.ts";
 import { needs } from "../ui/needs.ts";
-import { CHARACTERS } from "../pet/characters.ts";
-import { petPixels } from "../pet/pixels.ts";
 import { createHash, randomBytes } from "node:crypto";
 import { readFileSync } from "node:fs";
 
@@ -41,7 +39,7 @@ export function startDashboard(options: DashboardOptions) {
     .replace("/* TASK_PROGRESS_MODEL */", () => `const taskProgress = ${taskProgress.toString()};`)
     .replace("/* PEER_START_RETRY_MS */", () => `const PEER_START_RETRY_MS = ${PEER_START_RETRY_MS};`)
     .replace("/* OFFICE_MODEL */", () => `const officeModel = ${officeModel.toString()};`)
-    .replace("/* PET_MODEL */", () => `const needs = ${needs.toString()}; const petCharacters = ${JSON.stringify(Object.fromEntries(Object.entries(CHARACTERS).map(([id, character]) => [id, { name: character.name, accent: character.accent, frames: { blocks: Object.fromEntries(Object.entries(character.frames.blocks).map(([pose, sizes]) => [pose, { full: sizes.full }])) } }])))}; const petPixels = ${petPixels.toString()};`);
+    .replace("/* NEEDS_MODEL */", () => `const needs = ${needs.toString()};`);
   const hashes = (tag: string) => [...html.matchAll(new RegExp(`<${tag}>([\\s\\S]*?)</${tag}>`, "g"))]
     .map((m) => `'sha256-${createHash("sha256").update(m[1]!).digest("base64")}'`).join(" ");
   const headers = {

package/src/pet/config.ts

@@ -1,14 +1,47 @@
-import { readFileSync } from "node:fs";
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { randomUUID } from "node:crypto";
 import { join } from "node:path";
 import { characterId, type CharacterId, type PetSize, type PetGlyphs } from "./frame.ts";
 
-export interface PetConfig { enabled: boolean; blink: boolean; bell: boolean; character?: CharacterId; size?: PetSize; glyphs?: PetGlyphs; notice?: string }
+export type PetPalette = "blue" | "teal" | "violet" | "ochre";
+const PALETTES: Record<string, PetPalette> = { a: "blue", b: "teal", c: "violet", d: "ochre", blue: "blue", teal: "teal", violet: "violet", ochre: "ochre" };
+export function petPalette(value: unknown): PetPalette | undefined {
+  return typeof value === "string" ? PALETTES[value.toLowerCase()] : undefined;
+}
+export interface PetConfig { enabled: boolean; blink: boolean; bell: boolean; character?: CharacterId; size?: PetSize; glyphs?: PetGlyphs; palette?: PetPalette; notice?: string; window?: boolean }
+/** Console-local presentation only; it merges pet.palette into config.local.json and grants no authority. */
+export function savePetPalette(cwd: string, value: string): string {
+  const palette = petPalette(value);
+  if (!palette) throw new Error("Unknown pet palette; use blue, teal, violet or ochre (a/b/c/d).");
+  const dir = join(cwd, ".agenthub");
+  const path = join(dir, "config.local.json");
+  let file: Record<string, unknown> = {};
+  try {
+    const parsed: unknown = JSON.parse(readFileSync(path, "utf8"));
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("malformed");
+    file = parsed as Record<string, unknown>;
+  } catch (error) {
+    if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw new Error("Cannot update config.local.json; it is malformed.");
+  }
+  const pet = file.pet && typeof file.pet === "object" && !Array.isArray(file.pet) ? file.pet as Record<string, unknown> : {};
+  mkdirSync(dir, { recursive: true });
+  const temporary = join(dir, `config.local.${randomUUID()}.tmp`);
+  try {
+    writeFileSync(temporary, JSON.stringify({ ...file, pet: { ...pet, palette } }, null, 2) + "\n", { flag: "wx" });
+    renameSync(temporary, path);
+  } finally { rmSync(temporary, { force: true }); }
+  return `Pet palette set to ${palette}.`;
+}
 /** Console-local presentation only; this reader never writes config or grants authority. */
 export function loadPetConfig(cwd: string): PetConfig {
   let value: unknown;
+  let enabled = true;
   for (const name of ["config.json", "config.local.json"]) {
     try {
       const file = JSON.parse(readFileSync(join(cwd, ".agenthub", name), "utf8"));
+      // A window-only local opt-in does not undo inherited pet:false presentation.
+      if (file.pet === false) enabled = false;
+      else if (file.pet !== undefined && !(file.pet && typeof file.pet === "object" && !Array.isArray(file.pet) && Object.keys(file.pet).length === 1 && Object.hasOwn(file.pet, "window"))) enabled = true;
       if (file.pet !== undefined) value = value && typeof value === "object" && file.pet && typeof file.pet === "object" ? { ...value, ...file.pet } : file.pet;
     } catch (error) {
       if ((error as NodeJS.ErrnoException).code !== "ENOENT") throw error;
@@ -19,13 +52,17 @@ export function loadPetConfig(cwd: string): PetConfig {
   if (value === undefined) return defaults;
   if (!value || typeof value !== "object" || Array.isArray(value)) return { ...defaults, notice: "Unknown pet configuration; using stai line defaults." };
   const row = value as Record<string, unknown>;
-  const invalid = Object.keys(row).some(key => !["character", "size", "glyphs", "blink", "bell"].includes(key)) ||
+  const invalid = Object.keys(row).some(key => !["character", "size", "glyphs", "blink", "bell", "palette", "window"].includes(key)) ||
     row.character !== undefined && !characterId(row.character) || row.size !== undefined && !["line", "mini", "full"].includes(row.size as string) ||
     row.glyphs !== undefined && (typeof row.glyphs !== "string" || !["auto", "ascii", "blocks"].includes(row.glyphs)) ||
-    row.blink !== undefined && typeof row.blink !== "boolean" || row.bell !== undefined && typeof row.bell !== "boolean";
-  return { enabled: true, blink: typeof row.blink === "boolean" ? row.blink : true, bell: typeof row.bell === "boolean" ? row.bell : false,
+    row.palette !== undefined && !petPalette(row.palette) ||
+    row.blink !== undefined && typeof row.blink !== "boolean" || row.bell !== undefined && typeof row.bell !== "boolean" || row.window !== undefined && typeof row.window !== "boolean";
+  const palette = petPalette(row.palette);
+  return { enabled, blink: typeof row.blink === "boolean" ? row.blink : true, bell: typeof row.bell === "boolean" ? row.bell : false,
+    ...(typeof row.window === "boolean" ? { window: row.window } : {}),
     ...(characterId(row.character) && row.character !== "stai" ? { character: row.character } : {}),
     ...(row.size === "mini" || row.size === "full" ? { size: row.size } : {}),
     ...(row.glyphs === "ascii" || row.glyphs === "blocks" ? { glyphs: row.glyphs } : {}),
+    ...(palette && palette !== "teal" ? { palette } : {}),
     ...(invalid ? { notice: "Unknown pet option; using stai line defaults for that option." } : {}) };
 }

package/src/pet/window.html

@@ -0,0 +1,114 @@
+<!doctype html>
+<html lang="en">
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'unsafe-inline'; style-src 'unsafe-inline'; connect-src 'none'; base-uri 'none'; form-action 'none'">
+<title>agent-hub pet</title>
+<style>
+:root { color-scheme: dark; font: 12px system-ui, sans-serif; color: #eceef3; }
+html, body { margin: 0; background: transparent; overflow: hidden; }
+body { width: 150px; height: 150px; display: flex; align-items: center; flex-direction: column; justify-content: flex-end; gap: 4px; padding-bottom: 4px; box-sizing: border-box; }
+button { font: inherit; color: inherit; cursor: pointer; border: 0; background: transparent; border-radius: 10px; }
+button:focus-visible, input:focus-visible { outline: 2px solid #79dfb2; outline-offset: 2px; }
+#pet { width: 63px; height: 58px; padding: 0; cursor: grab; touch-action: none; }
+#pet:active { cursor: grabbing; }
+svg { width: 100%; height: 100%; overflow: visible; image-rendering: pixelated; filter: drop-shadow(0 1px 1px #687a78) drop-shadow(0 0 1px #687a78); }
+[data-palette="blue"] svg { filter: drop-shadow(0 1px 1px #64748b) drop-shadow(0 0 1px #64748b); }
+[data-palette="violet"] svg { filter: drop-shadow(0 1px 1px #796d8b) drop-shadow(0 0 1px #796d8b); }
+[data-palette="ochre"] svg { filter: drop-shadow(0 1px 1px #81725f) drop-shadow(0 0 1px #81725f); }
+rect { fill: #168b87; }
+[data-palette="blue"] rect { fill: #3979d6; }
+[data-palette="violet"] rect { fill: #8864cc; }
+[data-palette="ochre"] rect { fill: #be7a22; }
+[data-state="waiting"] rect { fill: #c4880f; }
+[data-state="blocked"] rect { fill: #cf6156; }
+[data-state="review"] rect { fill: #8a6cd8; }
+[data-state="offline"] rect { fill: #6f7787; }
+body[data-state="working"] #frame { animation: working-bob 0.7s steps(3, end) infinite; }
+@keyframes working-bob {
+  0%, 100% { transform: translateY(0); }
+  50% { transform: translateY(-4px); }
+}
+@media (prefers-reduced-motion: reduce) {
+  body[data-state="working"] #frame { animation: none; }
+}
+#pill { display: flex; align-items: center; gap: 4px; border-radius: 14px; padding: 3px 7px; background: #242936ed; font-size: 11px; }
+#pill button { padding: 2px 4px; }
+#composer { width: 100%; background: #242936f5; padding: 4px; border-radius: 10px; box-sizing: border-box; }
+#composer[hidden] { display: none; }
+/* Hidden by opacity only: visibility would drop the #state live region from the a11y tree. */
+#pill { opacity: 0; pointer-events: none; transition: opacity .12s ease; }
+#pet:hover ~ #pill, #pet:focus-visible ~ #pill, #pill:hover, #pill:focus-within, body[data-hover] #pill, body[data-composing] #pill { opacity: 1; pointer-events: auto; }
+input { width: 100%; box-sizing: border-box; border: 1px solid #657081; border-radius: 6px; padding: 5px; background: #111722; color: #eceef3; font: 13px system-ui; }
+#result { margin-top: 2px; min-height: 12px; font-size: 11px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+</style>
+<button id="pet" aria-label="Open agent-hub dashboard"><svg id="frame" role="img" aria-label="Pet" viewBox="0 0 60 64"></svg></button>
+<div id="pill"><span id="state" aria-live="polite">Starting</span><button id="pencil" aria-label="Write a console message">✎</button><button id="close" aria-label="Close pet window">×</button></div>
+<div id="composer" hidden><input id="message" aria-label="Console message" placeholder="Message, Enter to send" maxlength="65536"><div id="result" role="status">Esc to cancel</div></div>
+<script>
+const post = body => window.webkit.messageHandlers.pet.postMessage(body);
+const pet = document.getElementById('pet'), frame = document.getElementById('frame'), pill = document.getElementById('pill');
+const state = document.getElementById('state'), composer = document.getElementById('composer'), input = document.getElementById('message'), result = document.getElementById('result');
+let signature = '', drag, sending = false;
+const draw = (x, y, w, h) => {
+  const rect = document.createElementNS('http://www.w3.org/2000/svg', 'rect');
+  rect.setAttribute('x', x); rect.setAttribute('y', y); rect.setAttribute('width', w); rect.setAttribute('height', h);
+  return rect;
+};
+window.update = view => {
+  if (view.offline) {
+    document.body.dataset.state = 'offline'; state.textContent = 'Offline';
+    document.getElementById('pencil').disabled = true; return;
+  }
+  document.getElementById('pencil').disabled = false;
+  document.body.dataset.state = view.state;
+  document.body.dataset.palette = view.palette;
+  state.textContent = view.state + (view.act ? ' · act ' + view.act : '') + (view.watch ? ' · watch ' + view.watch : '');
+  pet.setAttribute('aria-label', 'Open dashboard, ' + state.textContent);
+  const next = JSON.stringify(view.frame);
+  if (signature === next) return;
+  signature = next;
+  frame.setAttribute('viewBox', '0 0 ' + view.frame.width + ' ' + view.frame.height);
+  frame.replaceChildren(...view.frame.pixels.map(([x, y]) => draw(x, y, 1, 1)));
+};
+window.focusInput = () => { document.body.dataset.composing = ''; composer.hidden = false; input.focus(); };
+window.commandResult = ok => { sending = false; input.disabled = false; result.textContent = ok ? 'Sent' : 'Not confirmed; check the dashboard.'; if (ok) { input.value = ''; composer.hidden = true; delete document.body.dataset.composing; } };
+document.getElementById('pencil').addEventListener('click', () => post({ kind: 'pencil' }));
+document.getElementById('close').addEventListener('click', () => post({ kind: 'close' }));
+input.addEventListener('keydown', event => {
+  if (event.key === 'Escape') { composer.hidden = true; delete document.body.dataset.composing; pet.focus(); }
+  if (event.key === 'Enter' && !event.isComposing && input.value.trim() && !sending) {
+    event.preventDefault(); sending = true; input.disabled = true; result.textContent = 'Sending'; post({ kind: 'send', text: input.value });
+  }
+});
+// The native host polls the global mouse position against this rect (pet + pill) and
+// calls hoverChanged, because an inactive accessory panel never fires CSS :hover.
+window.hoverChanged = on => { if (on) document.body.dataset.hover = ''; else delete document.body.dataset.hover; };
+const postHotspot = () => {
+  const a = pet.getBoundingClientRect(), b = pill.getBoundingClientRect();
+  const x = Math.min(a.x, b.x), y = Math.min(a.y, b.y);
+  post({ kind: 'hotspot', x, y, w: Math.max(a.right, b.right) - x, h: Math.max(a.bottom, b.bottom) - y });
+};
+// While the panel is key, 1/2/3/4 switch the palette (blue/teal/violet/ochre) and save it.
+const KEY_PALETTES = { '1': 'blue', '2': 'teal', '3': 'violet', '4': 'ochre' };
+document.addEventListener('keydown', event => {
+  const palette = KEY_PALETTES[event.key];
+  if (!palette || event.target === input) return;
+  document.body.dataset.palette = palette;
+  post({ kind: 'palette', palette });
+});
+pet.addEventListener('pointerdown', event => { drag = { x: event.screenX, y: event.screenY, moved: false }; pet.setPointerCapture(event.pointerId); });
+pet.addEventListener('pointermove', event => {
+  if (!drag) return;
+  const dx = event.screenX - drag.x, dy = event.screenY - drag.y;
+  if (!dx && !dy) return;
+  drag.moved = true; drag.x = event.screenX; drag.y = event.screenY;
+  post({ kind: 'drag', dx, dy });
+});
+pet.addEventListener('pointerup', () => { const moved = drag?.moved; drag = null; if (!moved) post({ kind: 'open' }); });
+pet.addEventListener('pointercancel', () => { drag = null; });
+pet.addEventListener('keydown', event => { if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); post({ kind: 'open' }); } });
+postHotspot();
+post({ kind: 'ready' });
+</script>
+</html>

package/src/pet/window.jxa.js

@@ -0,0 +1,122 @@
+// Local AppKit/WebKit surface. No shell evaluation or remote content.
+ObjC.import('Cocoa');
+ObjC.import('WebKit');
+var panel, web, app, viewPath, positionPath, readyPath, cliArgv, timer, hoverTimer, bridge;
+var offlineAt = 0, commands = [], exiting = false, hotspot = null, hovering = false;
+function ignoreCompletion(result, error) {}
+function evaluate(source) { web.evaluateJavaScriptCompletionHandler(source, ignoreCompletion); }
+// An inactive accessory panel receives no mouse-moved events, so hover reveal is
+// polled from the global mouse position against the hotspot rect the page posts.
+function pollHover() {
+  if (!hotspot || exiting) return;
+  var mouse = $.NSEvent.mouseLocation, frame = panel.frame;
+  var x = mouse.x - frame.origin.x, y = frame.origin.y + frame.size.height - mouse.y;
+  var inside = x >= hotspot.x && x <= hotspot.x + hotspot.w && y >= hotspot.y && y <= hotspot.y + hotspot.h;
+  if (inside !== hovering) { hovering = inside; evaluate('hoverChanged(' + inside + ')'); }
+}
+function savePosition() {
+  var origin = panel.frame.origin;
+  $(JSON.stringify({ x: origin.x, y: origin.y })).writeToFileAtomicallyEncodingError(positionPath, true, $.NSUTF8StringEncoding, null);
+}
+function quit() { exiting = true; savePosition(); app.terminate(null); }
+function runCommand(command, extra, argv) {
+  if (exiting || commands.length >= 8) return;
+  var task = $.NSTask.alloc.init;
+  task.executableURL = $.NSURL.fileURLWithPath(argv[0]);
+  var args = argv.slice(1).concat([command]).concat(extra);
+  task.arguments = $(args); // argv array only; message text is a single argument.
+  task.standardInput = $.NSFileHandle.fileHandleWithNullDevice;
+  task.standardOutput = $.NSFileHandle.fileHandleWithNullDevice;
+  task.standardError = $.NSFileHandle.fileHandleWithNullDevice;
+  if (task.launchAndReturnError(null)) commands.push({ task: task, command: command });
+  else evaluate('commandResult(false)');
+}
+ObjC.registerSubclass({ name: 'AhubPetPanel', superclass: 'NSPanel', methods: {
+  canBecomeKeyWindow: { types: ['bool', []], implementation: function() { return true; } },
+  canBecomeMainWindow: { types: ['bool', []], implementation: function() { return false; } }
+} });
+// JXA cannot resolve WKScriptMessageHandler by name on some macOS versions;
+// WebKit invokes the exact Objective-C selector on this retained subclass.
+ObjC.registerSubclass({ name: 'AhubPetBridge', superclass: 'NSObject', methods: {
+  'userContentController:didReceiveScriptMessage:': { types: ['void', ['id', 'id']], implementation: function(controller, message) {
+    var body = ObjC.deepUnwrap(message.body);
+    if (!body || typeof body !== 'object' || exiting) return;
+    if (body.kind === 'ready') {
+      tick();
+      $('ready').writeToFileAtomicallyEncodingError(readyPath, true, $.NSUTF8StringEncoding, null);
+    } else if (body.kind === 'pencil') {
+      panel.orderFrontRegardless; panel.makeKeyWindow;
+      evaluate('focusInput()');
+    } else if (body.kind === 'drag' && typeof body.dx === 'number' && typeof body.dy === 'number' && isFinite(body.dx) && isFinite(body.dy) && Math.abs(body.dx) <= 2000 && Math.abs(body.dy) <= 2000) {
+      var origin = panel.frame.origin;
+      panel.setFrameOrigin($.NSMakePoint(origin.x + body.dx, origin.y - body.dy));
+      savePosition();
+    } else if (body.kind === 'hotspot' && typeof body.x === 'number' && typeof body.y === 'number' && typeof body.w === 'number' && typeof body.h === 'number' && isFinite(body.x) && isFinite(body.y) && Math.abs(body.x) <= 500 && Math.abs(body.y) <= 500 && body.w > 0 && body.h > 0 && body.w <= 500 && body.h <= 500) {
+      hotspot = { x: body.x, y: body.y, w: body.w, h: body.h };
+    } else if (body.kind === 'send' && typeof body.text === 'string' && body.text.trim() && body.text.length <= 65536 && body.text.indexOf('\0') === -1) {
+      runCommand('say', ['--', body.text], cliArgv);
+    } else if (body.kind === 'palette' && typeof body.palette === 'string' && /^(blue|teal|violet|ochre)$/.test(body.palette)) {
+      runCommand('pet', ['--palette', body.palette], cliArgv);
+    } else if (body.kind === 'open') runCommand('ui', [], cliArgv);
+    else if (body.kind === 'close') quit();
+  } },
+  'tick:': { types: ['void', ['id']], implementation: function(sender) { tick(); } },
+  'hover:': { types: ['void', ['id']], implementation: function(sender) { pollHover(); } }
+} });
+function tick() {
+  var value;
+  try { value = JSON.parse(ObjC.unwrap($.NSString.stringWithContentsOfFileEncodingError(viewPath, $.NSUTF8StringEncoding, null))); }
+  catch (error) { value = { offline: true }; }
+  evaluate('update(' + JSON.stringify(value) + ')');
+  if (value.offline === true) { if (!offlineAt) offlineAt = Date.now(); if (Date.now() - offlineAt >= 2000) quit(); }
+  else offlineAt = 0;
+  commands = commands.filter(function(item) {
+    if (item.task.isRunning) return true;
+    if (item.command === 'say') evaluate('commandResult(' + (Number(item.task.terminationStatus) === 0) + ')');
+    return false;
+  });
+}
+function run(argv) {
+  if (argv.length !== 3) throw new Error('Invalid pet window arguments');
+  viewPath = argv[0];
+  var htmlPath = argv[1];
+  cliArgv = JSON.parse(argv[2]);
+  if (!Array.isArray(cliArgv) || cliArgv.length !== 4 || cliArgv.some(function(arg) { return typeof arg !== 'string'; }) || cliArgv[2] !== '--project') throw new Error('Invalid CLI argv');
+  var stateDir = ObjC.unwrap($(viewPath).stringByDeletingLastPathComponent);
+  positionPath = stateDir + '/pet-window-pos.json';
+  var owner = JSON.parse(ObjC.unwrap($.NSString.stringWithContentsOfFileEncodingError(stateDir + '/pet-window.pid', $.NSUTF8StringEncoding, null)));
+  readyPath = stateDir + '/pet-window-ready-' + owner.token;
+  app = $.NSApplication.sharedApplication;
+  app.setActivationPolicy($.NSApplicationActivationPolicyAccessory);
+  var screen = $.NSScreen.mainScreen.visibleFrame;
+  var W = 150, H = 150;
+  var origin = { x: screen.origin.x + screen.size.width - (W + 20), y: screen.origin.y + 80 };
+  try {
+    var saved = JSON.parse(ObjC.unwrap($.NSString.stringWithContentsOfFileEncodingError(positionPath, $.NSUTF8StringEncoding, null)));
+    if (typeof saved.x === 'number' && typeof saved.y === 'number' && isFinite(saved.x) && isFinite(saved.y)) origin = saved;
+  } catch (error) {}
+  var screens = $.NSScreen.screens;
+  var visible = false;
+  for (var i = 0; i < screens.count; i++) {
+    var frame = screens.objectAtIndex(i).visibleFrame;
+    if (origin.x >= frame.origin.x && origin.y >= frame.origin.y && origin.x + W <= frame.origin.x + frame.size.width && origin.y + H <= frame.origin.y + frame.size.height) visible = true;
+  }
+  if (!visible) origin = { x: screen.origin.x + screen.size.width - (W + 20), y: screen.origin.y + 80 };
+  panel = $.AhubPetPanel.alloc.initWithContentRectStyleMaskBackingDefer($.NSMakeRect(origin.x, origin.y, W, H), $.NSWindowStyleMaskBorderless | $.NSWindowStyleMaskNonactivatingPanel, $.NSBackingStoreBuffered, false);
+  panel.title = 'agent-hub pet'; panel.opaque = false; panel.backgroundColor = $.NSColor.clearColor;
+  panel.level = $.NSFloatingWindowLevel;
+  panel.collectionBehavior = $.NSWindowCollectionBehaviorCanJoinAllSpaces | $.NSWindowCollectionBehaviorStationary;
+  panel.hidesOnDeactivate = false;
+  panel.acceptsMouseMovedEvents = true; // CSS :hover while key; pollHover() covers the inactive case
+  var config = $.WKWebViewConfiguration.alloc.init;
+  bridge = $.AhubPetBridge.alloc.init;
+  config.userContentController.addScriptMessageHandlerName(bridge, 'pet');
+  web = $.WKWebView.alloc.initWithFrameConfiguration($.NSMakeRect(0, 0, W, H), config);
+  web.setValueForKey(false, 'drawsBackground');
+  panel.contentView = web;
+  web.loadFileURLAllowingReadAccessToURL($.NSURL.fileURLWithPath(htmlPath), $.NSURL.fileURLWithPath(htmlPath));
+  panel.orderFrontRegardless; panel.makeKeyWindow;
+  timer = $.NSTimer.scheduledTimerWithTimeIntervalTargetSelectorUserInfoRepeats(1, bridge, 'tick:', null, true);
+  hoverTimer = $.NSTimer.scheduledTimerWithTimeIntervalTargetSelectorUserInfoRepeats(0.1, bridge, 'hover:', null, true);
+  app.run;
+}