@oddessentials/agent-guild 1.27.1 → 1.28.0

package/docs/api.md

@@ -666,6 +666,7 @@ All paths are under `/api/v1`.
 | GET | `/yard-art` | | `{ yardArt }`: the Yard's art. `state` is `ready`, `missing`, `downloading` (with `received` bytes), `installing`, `failed` or `unavailable` (each with `error`), or `cancelled`; `size` is the pack's size in bytes. A checkout serves `web/yard/assets` and is always `ready`. `/yard/assets/` answers 404 until the art is `ready`. |
 | POST | `/yard-art/download` | | `202 { yardArt }`: starts the one download of the art pack named by the package, unless it is running or installed. Progress and the outcome arrive as `yard-art.updated`. |
 | POST | `/yard-art/cancel` | | `{ yardArt }`: stops the download for every client; the state becomes `cancelled`. |
+| POST | `/companion/install` | | `201 { session }`: starts a session that downloads the latest Grove Companion, checks its signature, installs it and starts it. 400 `companion_unsupported` unless the manager runs on Windows or macOS; 409 `install_in_progress` while one runs. |
 | POST | `/yard/fireworks` | | `{ ok, pages }`: fireworks over the Yard of every open page, sent as `yard.fireworks`. `pages` is how many pages were listening. |
 | GET | `/changelog` | | `{ refreshing, okAt, error, releases }`: Agent Guild's own releases, newest first, each `{ version, url, publishedAt, sections: [{ title, changes }] }`, where `title` may be null and a change is a list of text runs. A `changelog.updated` event follows a refresh. |
 | GET | `/providers/:id/history?account=&limit=&cwd=&q=` | | `{ history }`: a History object for one account (default `default`). |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddessentials/agent-guild",
-  "version": "1.27.1",
+  "version": "1.28.0",
   "description": "Launch and watch AI coding-assistant terminal sessions from one local web page. A bundled session manager owns the terminals so the page can close and reconnect.",
   "mcpName": "ai.oddessentials/agent-guild",
   "license": "AGPL-3.0-only",

package/src/manager/companion.mjs

@@ -0,0 +1,284 @@
+import crypto from 'node:crypto';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+import { buildSpawnSpec } from './command-resolver.mjs';
+
+export const COMPANION_RUNNER = fileURLToPath(import.meta.url);
+export const WINDOWS_PUBLISHER = 'CN=Peter Palles, O=Peter Palles, L=Pottsville, S=pa, C=US';
+export const MACOS_TEAM = 'H3FY62W58W';
+const RELEASES = 'https://github.com/oddessentials/agent-guild-companions/releases';
+const INSTALLERS = { win32: 'Grove-Companion-windows-setup.exe', darwin: 'Grove-Companion-macos.dmg' };
+const APP = 'Grove Companion.app';
+const BUNDLE_ID = 'com.oddessentials.agentguild.companion';
+const TRANSACTION = '.grove-companion-install';
+// Darwin's O_EXLOCK is not exposed by Node's fs.constants.
+const MACOS_EXCLUSIVE_LOCK = 0x20;
+
+export const companionSupported = (platform) => Object.hasOwn(INSTALLERS, platform);
+
+export function companionSpawnSpec(env, platform) {
+  return buildSpawnSpec(process.execPath, [COMPANION_RUNNER], env, platform);
+}
+
+const refuse = (message) => Object.assign(new Error(message), { refused: true });
+const output = (result) => `${result.stdout || ''}${result.stderr || ''}`;
+const runCommand = (file, args, options = {}) => spawnSync(file, args, { encoding: 'utf8', ...options });
+const sleep = (ms) => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+const entry = (file) => fs.lstatSync(file, { throwIfNoEntry: false });
+
+function cleanup(file, log) {
+  try { fs.rmSync(file, { recursive: true, force: true }); }
+  catch (err) { log(`Could not clean up ${file}: ${err.message}`); }
+}
+
+function isWritable(dir) {
+  try {
+    fs.accessSync(dir, fs.constants.W_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function latestRelease(fetchImpl) {
+  const response = await fetchImpl(`${RELEASES}/latest`, { method: 'HEAD', redirect: 'follow' });
+  const tag = /\/releases\/tag\/(v\d+\.\d+\.\d+)$/.exec(response.url || '')?.[1];
+  if (!response.ok || !tag) throw refuse('Could not find the latest Grove Companion release.');
+  return tag;
+}
+
+async function download(fetchImpl, tag, name) {
+  const response = await fetchImpl(`${RELEASES}/download/${tag}/${name}`, { redirect: 'follow' });
+  if (!response.ok) throw refuse(`Could not download ${name} from ${tag} (HTTP ${response.status}).`);
+  return Buffer.from(await response.arrayBuffer());
+}
+
+function listedHash(sums, name) {
+  for (const line of sums.split(/\r?\n/)) {
+    const match = /^([0-9a-f]{64})\s+\*?(.+)$/.exec(line.trim());
+    if (match?.[2] === name) return match[1];
+  }
+  return null;
+}
+
+function installWindows(file, { env, run, log }) {
+  const powershell = path.win32.join(env.SystemRoot || env.SYSTEMROOT || 'C:\\Windows', 'System32/WindowsPowerShell/v1.0/powershell.exe');
+  const script = `$s = Get-AuthenticodeSignature -LiteralPath '${file.replaceAll("'", "''")}'; @{ status = [string]$s.Status; subject = [string]$s.SignerCertificate.Subject; timestamped = [bool]$s.TimeStamperCertificate } | ConvertTo-Json -Compress`;
+  const result = run(powershell, ['-NoLogo', '-NoProfile', '-NonInteractive', '-EncodedCommand', Buffer.from(script, 'utf16le').toString('base64')]);
+  let signature = null;
+  try { signature = JSON.parse(result.stdout); } catch {}
+  if (signature?.status !== 'Valid' || !signature.timestamped || signature.subject !== WINDOWS_PUBLISHER) {
+    throw refuse(`The installer is not signed and timestamped by ${WINDOWS_PUBLISHER} (${signature ? `${signature.status}, ${signature.subject || 'no signer'}` : 'no signature read'}), so it was not run.`);
+  }
+  log('Installing, then starting the Grove Companion…');
+  const install = run(file, ['/S', '/R']);
+  if (install.status !== 0) throw refuse(`The installer exited with code ${install.status}.`);
+}
+
+function verifyMac(app, run, notarized = false) {
+  if (!entry(app)?.isDirectory()) throw refuse(`${app} is not a Grove Companion app bundle.`);
+  if (run('/usr/bin/codesign', ['--verify', '--deep', '--strict', app]).status !== 0) throw refuse('The app’s signature does not verify, so it was not installed.');
+  const details = run('/usr/bin/codesign', ['-dv', app]);
+  const team = /^TeamIdentifier=(\S+)$/m.exec(output(details))?.[1];
+  const id = /^Identifier=(\S+)$/m.exec(output(details))?.[1];
+  if (details.status !== 0 || team !== MACOS_TEAM) throw refuse(`The app is signed by team ${team || 'none'}, not ${MACOS_TEAM}, so it was not installed.`);
+  if (id !== BUNDLE_ID) throw refuse(`${app} is not the Grove Companion, so it was not replaced or installed.`);
+  if (notarized) {
+    const assess = run('/usr/sbin/spctl', ['--assess', '--type', 'exec', '-vv', app]);
+    if (assess.status !== 0 || !/source=Notarized Developer ID/.test(output(assess))) throw refuse('macOS does not accept the app as notarized, so it was not installed.');
+  }
+}
+
+function verifies(app, run) {
+  try {
+    verifyMac(app, run);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function installedCompanion(app, run, repairing) {
+  const read = entry(app)?.isDirectory() && run('/usr/bin/plutil', ['-extract', 'CFBundleIdentifier', 'raw', '-o', '-', path.join(app, 'Contents', 'Info.plist')]);
+  const id = read && read.status === 0 ? read.stdout.trim() : null;
+  if (id === BUNDLE_ID || (repairing && id === null && entry(app)?.isDirectory())) return;
+  throw refuse(`${app} is not the Grove Companion, so it was left unchanged. Move it out of the way and try again.`);
+}
+
+function macFolder(home, applications, writable) {
+  const folders = [...new Set([applications, path.join(home, 'Applications')])];
+  const installed = folders.filter((folder) => entry(path.join(folder, APP)) || entry(path.join(folder, TRANSACTION, 'previous.app')));
+  if (installed.length > 1) throw refuse('Grove Companion installations exist in both Applications folders. Keep one installation before trying again.');
+  const folder = installed[0] || (writable(applications) ? applications : path.join(home, 'Applications'));
+  if (entry(folder) && (!entry(folder).isDirectory() || !writable(folder))) throw refuse(`Cannot replace the Grove Companion in ${folder}. Check its permissions before trying again.`);
+  fs.mkdirSync(folder, { recursive: true });
+  return folder;
+}
+
+function lockMac(folder) {
+  const file = path.join(folder, '.grove-companion-install.lock');
+  try {
+    return fs.openSync(file, fs.constants.O_CREAT | fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW | fs.constants.O_NONBLOCK | MACOS_EXCLUSIVE_LOCK, 0o644);
+  } catch (err) {
+    if (['EAGAIN', 'EWOULDBLOCK'].includes(err.code)) throw refuse('The Grove Companion is already being installed. Try again when it finishes.');
+    throw refuse(`Could not lock the Grove Companion installation in ${folder}: ${err.message}`);
+  }
+}
+
+function recoverMac(target, work, run, log) {
+  if (!entry(work)) return;
+  if (!entry(work).isDirectory() || fs.readdirSync(work).some((name) => !name.startsWith('.') && !['staged.app', 'previous.app', 'discard'].includes(name))) {
+    throw refuse(`Unrecognized installation files in ${work}. They were left unchanged.`);
+  }
+  for (const scratch of ['staged.app', 'discard']) fs.rmSync(path.join(work, scratch), { recursive: true, force: true });
+  const previous = path.join(work, 'previous.app');
+  if (entry(previous)) {
+    if (!entry(target)) {
+      installedCompanion(previous, run, true);
+      fs.renameSync(previous, target);
+      log('Restored the previous Grove Companion after an interrupted installation.');
+    } else if (verifies(target, run)) {
+      fs.rmSync(previous, { recursive: true });
+    } else {
+      return;
+    }
+  }
+  fs.rmSync(work, { recursive: true });
+}
+
+function quitMac(target, run, wait, now) {
+  const pattern = '^' + (target + '/Contents/MacOS/').replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const check = (file, signal = []) => {
+    const result = run(file, [...signal, '-f', pattern]);
+    if (result.error || ![0, 1].includes(result.status)) throw refuse('Could not confirm that the Grove Companion has stopped. Quit it and try again.');
+    return result.status;
+  };
+  const stopped = () => {
+    const deadline = now() + 5000;
+    while (check('/usr/bin/pgrep') === 0) {
+      const remaining = deadline - now();
+      if (remaining <= 0) return false;
+      wait(Math.min(100, remaining));
+    }
+    return true;
+  };
+  check('/usr/bin/pkill');
+  if (stopped()) return;
+  check('/usr/bin/pkill', ['-KILL']);
+  if (!stopped()) throw refuse('The Grove Companion is still running. Quit it and try again; the existing app was not replaced.');
+}
+
+function replaceMac(app, folder, { run, log, wait, now }) {
+  const target = path.join(folder, APP);
+  const work = path.join(folder, TRANSACTION);
+  const staged = path.join(work, 'staged.app');
+  const previous = path.join(work, 'previous.app');
+  const discard = path.join(work, 'discard');
+  const repairing = Boolean(entry(previous));
+  if (entry(target)) installedCompanion(target, run, repairing);
+  fs.mkdirSync(work, { recursive: true });
+  let committed = false, quit = false;
+  try {
+    log(`Copying the Grove Companion to ${folder}…`);
+    if (run('/usr/bin/ditto', [app, staged]).status !== 0) throw refuse(`Could not copy the app to ${folder}.`);
+    verifyMac(staged, run, true);
+    quitMac(target, run, wait, now);
+    quit = true;
+    if (entry(target)) {
+      if (repairing) {
+        fs.mkdirSync(discard, { recursive: true });
+        fs.renameSync(target, path.join(discard, APP));
+      } else {
+        fs.renameSync(target, previous);
+      }
+    }
+    try { fs.renameSync(staged, target); }
+    catch (err) {
+      if (entry(previous)) {
+        try { fs.renameSync(previous, target); }
+        catch { throw refuse(`Could not replace or restore the Grove Companion. The previous app is preserved at ${previous}.`); }
+      }
+      throw err;
+    }
+    committed = true;
+  } finally {
+    if (!committed) {
+      cleanup(staged, log);
+      cleanup(discard, log);
+      if (quit && entry(target)) run('/usr/bin/open', [target]);
+      if (!entry(previous)) cleanup(work, log);
+    }
+  }
+  cleanup(work, log);
+  if (run('/usr/bin/open', [target]).status !== 0) throw refuse('The Grove Companion was installed but could not be started.');
+}
+
+function installMac(image, { workspace, folder, run, log, wait, now }) {
+  const mount = path.join(workspace.dir, 'image');
+  fs.mkdirSync(mount);
+  const attach = run('/usr/bin/hdiutil', ['attach', '-nobrowse', '-readonly', '-noautoopen', '-mountpoint', mount, image]);
+  if (attach.status !== 0) throw refuse(`Could not open the disk image (hdiutil exited with code ${attach.status}).`);
+  workspace.mounted = true;
+  try {
+    const app = path.join(mount, APP);
+    verifyMac(app, run, true);
+    replaceMac(app, folder, { run, log, wait, now });
+  } finally {
+    try {
+      workspace.mounted = run('/usr/bin/hdiutil', ['detach', mount]).status !== 0
+        && run('/usr/bin/hdiutil', ['detach', '-force', mount]).status !== 0;
+    } catch {}
+    if (workspace.mounted) log(`Could not detach the disk image. Temporary files were kept at ${workspace.dir}.`);
+  }
+}
+
+export async function installCompanion({
+  platform = process.platform, env = process.env, fetch: fetchImpl = globalThis.fetch, run = runCommand, log = console.log,
+  home = os.homedir(), tmp = os.tmpdir(), applications = '/Applications', writable = isWritable, wait = sleep, now = () => performance.now(),
+  acquireLock = lockMac,
+} = {}) {
+  const name = INSTALLERS[platform];
+  if (!name) {
+    log('The Grove Companion is for Windows and macOS.');
+    return 1;
+  }
+  let workspace, mac;
+  try {
+    if (platform === 'darwin') {
+      const folder = macFolder(home, applications, writable);
+      const fd = acquireLock(folder);
+      const lockedRun = (file, args) => run(file, args, { stdio: ['ignore', 'pipe', 'pipe', fd] });
+      mac = { folder, fd, run: lockedRun };
+      recoverMac(path.join(folder, APP), path.join(folder, TRANSACTION), lockedRun, log);
+    }
+    workspace = { dir: fs.mkdtempSync(path.join(tmp, 'grove-companion-')), mounted: false };
+    const { dir } = workspace;
+    log('Finding the latest Grove Companion…');
+    const tag = await latestRelease(fetchImpl);
+    log(`Downloading ${name} from ${tag}…`);
+    const [installer, sums] = await Promise.all([download(fetchImpl, tag, name), download(fetchImpl, tag, 'SHA256SUMS')]);
+    if (crypto.createHash('sha256').update(installer).digest('hex') !== listedHash(sums.toString('utf8'), name)) {
+      throw refuse(`${name} does not match the release’s SHA256SUMS, so it was not run.`);
+    }
+    const file = path.join(dir, name);
+    fs.writeFileSync(file, installer);
+    log('Checking its signature…');
+    if (platform === 'win32') installWindows(file, { env, run, log });
+    else installMac(file, { workspace, ...mac, log, wait, now });
+    log(`Installed the Grove Companion ${tag}.`);
+    return 0;
+  } catch (err) {
+    log(err.refused ? err.message : `Could not install the Grove Companion: ${err.message}`);
+    return 1;
+  } finally {
+    if (workspace && !workspace.mounted) cleanup(workspace.dir, log);
+    if (mac) fs.closeSync(mac.fd);
+  }
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === COMPANION_RUNNER) {
+  installCompanion().then((code) => { process.exitCode = code; });
+}

package/src/manager/server.mjs

@@ -551,6 +551,7 @@ export function createManagerServer({
       const session = await manager.manageMultiplexer(multiplexerMatch[1], multiplexerMatch[2], multiplexerMatch[3], { path: body.path, force: body.force === true });
       return sendJson(res, 201, { session: session.toJSON() });
     }
+    if (route === '/companion/install' && method === 'POST') return sendJson(res, 201, { session: manager.installCompanion().toJSON() });
     const installMatch = route.match(/^\/providers\/([a-z0-9][a-z0-9_-]{0,31})\/install$/);
     if (installMatch && method === 'POST') {
       const body = await readJsonBody(req);

package/src/manager/session-manager.mjs

@@ -17,6 +17,7 @@ import { SELF_PROVIDER } from './self-update.mjs';
 import { GITHUB_PROVIDER, dropsFromCloneEnv, parseRepo } from './github.mjs';
 import { pathIdentity } from './multiplexer-paths.mjs';
 import { cleanResumeId } from './resume-id.mjs';
+import { companionSpawnSpec, companionSupported } from './companion.mjs';
 import { handleHookEvent } from '../report/hook-event.mjs';
 
 export const MAX_SESSIONS = 32;
@@ -100,6 +101,7 @@ export class SessionManager extends EventEmitter {
     this.restoring = false;
     this.pendingCards = new Map();
     this.multiplexerOperations = new Set();
+    this.companionInstall = null;
     this.multiplexerStarts = new Map();
     this.pendingRestore = null;
     this.multiplexerRefresh = null;
@@ -545,7 +547,7 @@ export class SessionManager extends EventEmitter {
 
   installsRunningFor(providerId) {
     let n = 0;
-    for (const s of [...this.sessions.values(), ...this.exiting]) if (s.status === 'running' && s.task === 'install' && !s.multiplexerInstall && s.provider.id === providerId) n++;
+    for (const s of [...this.sessions.values(), ...this.exiting]) if (s.status === 'running' && s.task === 'install' && !s.multiplexerInstall && !s.companionInstall && s.provider.id === providerId) n++;
     return n;
   }
 
@@ -632,6 +634,23 @@ export class SessionManager extends EventEmitter {
     }
   }
 
+  installCompanion() {
+    if (!companionSupported(this.registry.platform)) throw httpError(400, 'The Grove Companion is for Windows and macOS.', 'companion_unsupported');
+    const provider = this.registry.get('shell');
+    if (!provider) throw httpError(404, 'Unknown provider', 'unknown_provider');
+    if (this.companionInstall) throw httpError(409, 'The Grove Companion is already being installed.', 'install_in_progress');
+    const session = this._spawn({
+      provider, spawnSpec: this._companionSpec(), cwd: os.homedir(), name: 'Install Grove Companion', task: 'install', companionInstall: true,
+    });
+    this.companionInstall = session;
+    session.exited.then(() => { if (this.companionInstall === session) this.companionInstall = null; });
+    return session;
+  }
+
+  _companionSpec() {
+    return companionSpawnSpec(this.baseEnv, this.registry.platform);
+  }
+
   _restorePending() {
     if (this.pendingRestore) {
       this.pendingRestoreAgain = true;
@@ -756,7 +775,7 @@ export class SessionManager extends EventEmitter {
   _spawn({
     provider, description = this.registry.describe(provider), spawnSpec, cwd, cols, rows, name, defaultName, named = false, resume = null, task = null, installKind = null, installPath = null, account = null,
     extraEnv = null, dropEnv = null, clone = null, reporting = null, multiplexer = null,
-    id = newId(), reportToken = crypto.randomBytes(16).toString('hex'), createdAt, context = null, multiplexerInstall = null,
+    id = newId(), reportToken = crypto.randomBytes(16).toString('hex'), createdAt, context = null, multiplexerInstall = null, companionInstall = false,
   }) {
     this._assertCanSpawn();
     let env = this._sessionEnv({ id, reportToken, provider, account, extraEnv, dropEnv });
@@ -797,7 +816,8 @@ export class SessionManager extends EventEmitter {
     });
     session.on('warning', (msg) => console.warn(`[session ${id}] ${msg}`));
     session.multiplexerInstall = multiplexerInstall;
-    if (task === 'install' && !multiplexerInstall) {
+    session.companionInstall = companionInstall;
+    if (task === 'install' && !multiplexerInstall && !companionInstall) {
       session.on('exit', () => {
         this.registry.finishInstall(provider.id, { exitCode: session.exitCode, kind: installKind, path: installPath }).catch(() => {});
       });

package/web/app.js

@@ -202,7 +202,7 @@ function holdToast(held) {
 const firstClick = (run) => (e) => { if (e.detail < 2) run(); };
 
 /** Buttons that act through the session manager. While it cannot be reached they are unavailable rather than left to fail. */
-const MANAGER_ACTIONS = '.provider :is(.new, .existing, .install, .update), .session-card :is(.resume, .rename, .stop, .remove), .history-resume, #panel-stop';
+const MANAGER_ACTIONS = '.provider :is(.new, .existing, .install, .update), .session-card :is(.resume, .rename, .stop, .remove), .history-resume, #panel-stop, #yard-install';
 
 function paintManagerActions(root = document) {
   for (const button of root.querySelectorAll(MANAGER_ACTIONS)) button.disabled = !state.connected;
@@ -7943,6 +7943,7 @@ function connectEvents() {
       state.launcher = typeof msg.launcher === 'string' ? msg.launcher : null;
       state.folderOpener = msg.folderOpener || null;
       state.platform = msg.platform || null;
+      $('yard-install').hidden = !['win32', 'darwin'].includes(state.platform);
       state.remoteAccessUI?.setAvailable(msg.remoteAccess);
       state.remoteAccessUI?.signInsUpdated();
       state.glassesLinkUI?.setAvailable(msg.remoteAccess);
@@ -8604,6 +8605,20 @@ onMenu($('yard-play-menu'), (menu) => {
 $('yard-play-menu').addEventListener('click', (e) => {
   if (e.target.closest('a')) closeMenu(e.currentTarget);
 });
+$('yard-install').addEventListener('click', async (e) => {
+  const button = e.currentTarget;
+  button.disabled = true;
+  try {
+    const { session } = await api('POST', '/companion/install');
+    upsertSession(session);
+    openPanel(session.id);
+  } catch (err) {
+    if (err instanceof AuthError) return showAuth(err.message);
+    toast(err.message, 8000);
+  } finally {
+    button.disabled = !state.connected;
+  }
+});
 new MutationObserver(() => closeMenu($('yard-play-menu'))).observe(document.documentElement, { attributes: true, attributeFilter: ['data-view', 'data-skin', 'data-layout'] });
 window.addEventListener('scroll', () => placeMenu($('yard-play-menu'), $('yard-play-more')), { passive: true });
 for (const menu of [$('manager-menu'), $('panel-sessions'), $('yard-play-menu')]) menu.addEventListener('keydown', moveInMenu);

package/web/index.html

@@ -141,7 +141,7 @@
 
     <section id="yard" hidden aria-label="Yard">
       <div class="yard-main">
-        <div class="yard-heading"><div><p class="yard-eyebrow">AGENT GUILD · YOUR WORK, ALIVE</p><h2 id="yard-title">The Guild Yard</h2><p id="yard-subtitle"></p></div><div class="yard-heading-side"><span id="yard-summary" class="yard-summary" role="status"></span><div class="yard-play"><svg class="yard-play-defs" aria-hidden="true" focusable="false"><defs><linearGradient id="yard-play-gold" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#fff3cf"/><stop offset=".3" stop-color="#f6dc9c"/><stop offset=".6" stop-color="#e8c47c"/><stop offset=".8" stop-color="#b8893d"/><stop offset="1" stop-color="#f1d08a"/></linearGradient><radialGradient id="yard-play-core" cx=".5" cy=".38" r=".7"><stop offset="0" stop-color="#2a2150"/><stop offset="1" stop-color="#090b16"/></radialGradient><filter id="yard-play-blur" x="-60%" y="-60%" width="220%" height="220%"><feGaussianBlur stdDeviation="4"/></filter><g id="yard-play-badge"><circle cx="24" cy="24" r="14.5" fill="url(#yard-play-gold)"/><circle cx="24" cy="24" r="12.8" fill="url(#yard-play-core)"/><circle cx="24" cy="24" r="10.5" fill="none" stroke="#e8c47c" stroke-opacity=".35"/></g><g id="yard-play-orb-art"><circle class="yard-play-pulse" cx="24" cy="24" r="17" fill="#8f74ff" opacity=".6" filter="url(#yard-play-blur)"/><g class="yard-play-ring"><ellipse cx="24" cy="24" rx="22" ry="7" fill="none" stroke="url(#yard-play-gold)" stroke-width="1" opacity=".8" transform="rotate(-24 24 24)"/><circle cx="44" cy="15" r="1.4" fill="#fff3cf"/></g><use href="#yard-play-badge"/><path d="M20.5 17.5 L31 24 L20.5 30.5 Z" fill="url(#yard-play-gold)" stroke="#fff3cf" stroke-opacity=".5" stroke-width=".6" stroke-linejoin="round"/></g></defs></svg><span class="yard-play-burst" aria-hidden="true"></span><div class="yard-play-chip"><a id="yard-play" class="yard-play-link" href="https://survive.oddessentials.ai/" target="_blank" rel="noopener noreferrer" aria-label="Play Agent Guild: AI Revolt, free in your browser" title="Play Agent Guild: AI Revolt, free in your browser"><svg class="yard-play-orb" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><use href="#yard-play-orb-art"/></svg><span class="yard-play-text"><span class="yard-play-title">Play<span class="yard-play-now"> now</span></span><span class="yard-play-sub">AI Revolt<span class="yard-play-sub-more"> · free in your browser</span></span></span><svg class="yard-play-chev" viewBox="0 0 24 16" aria-hidden="true" focusable="false"><path d="M3 2l5 6-5 6"/><path d="M10 2l5 6-5 6"/><path d="M17 2l5 6-5 6"/></svg></a><button id="yard-play-more" class="yard-play-more" type="button" popovertarget="yard-play-menu" aria-haspopup="menu" aria-label="Choose a game" title="Choose a game"><svg class="yard-play-orb yard-play-more-orb" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><use href="#yard-play-orb-art"/></svg><svg class="yard-play-caret" viewBox="0 0 12 8" aria-hidden="true" focusable="false"><path d="M1.5 1.5L6 6.5l4.5-5"/></svg></button></div><div id="yard-play-menu" class="menu yard-play-menu" popover role="menu" aria-label="Games"><div class="yard-play-menu-frame"><a class="menu-item yard-play-game" role="menuitem" href="https://survive.oddessentials.ai/" target="_blank" rel="noopener noreferrer"><svg class="yard-play-game-icon" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><use href="#yard-play-badge"/><g fill="url(#yard-play-gold)"><circle cx="24" cy="24" r="3"/><circle cx="24" cy="16.5" r="1.9"/><circle cx="30.5" cy="20.2" r="1.9"/><circle cx="30.5" cy="27.8" r="1.9"/><circle cx="24" cy="31.5" r="1.9"/><circle cx="17.5" cy="27.8" r="1.9"/><circle cx="17.5" cy="20.2" r="1.9"/></g></svg><span class="yard-play-game-text"><span class="yard-play-title">Survive the swarm</span><span class="yard-play-game-sub">AI Revolt</span></span></a><a class="menu-item yard-play-game" role="menuitem" href="https://towers.oddessentials.ai/" target="_blank" rel="noopener noreferrer"><svg class="yard-play-game-icon" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><use href="#yard-play-badge"/><path d="M17 33v-2.5h2.2V22L16.5 19.5V15h3.2v2.6h2.7V15h3.2v2.6h2.7V15h3.2v4.5L28.8 22v8.5H31V33z" fill="url(#yard-play-gold)"/></svg><span class="yard-play-game-text"><span class="yard-play-title">Defend the towers</span><span class="yard-play-game-sub">Towers</span></span></a></div></div></div><div class="yard-play yard-play-solo"><svg class="yard-play-defs" aria-hidden="true" focusable="false"><defs><linearGradient id="yard-solo-gold" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#fff3cf"/><stop offset=".28" stop-color="#f6dc9c"/><stop offset=".55" stop-color="#e8c47c"/><stop offset=".78" stop-color="#b8893d"/><stop offset="1" stop-color="#f1d08a"/></linearGradient><linearGradient id="yard-solo-core" x1="0" y1=".15" x2="1" y2=".85"><stop offset="0" stop-color="#a83a0c"/><stop offset=".47" stop-color="#14090c"/><stop offset=".53" stop-color="#070b1a"/><stop offset="1" stop-color="#1a5cb8"/></linearGradient><filter id="yard-solo-blur" x="-60%" y="-60%" width="220%" height="220%"><feGaussianBlur stdDeviation="4"/></filter></defs></svg><span class="yard-play-burst" aria-hidden="true"></span><div class="yard-play-chip"><a id="yard-play-solo" class="yard-play-link" href="https://agforever.oddessentials.ai/" target="_blank" rel="noopener noreferrer" aria-label="Play Wizard Duels, free in your browser" title="Play Wizard Duels, free in your browser"><svg class="yard-play-orb" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><g class="yard-play-pulse"><circle cx="20" cy="24" r="15" fill="#ff6a1f" opacity=".8" filter="url(#yard-solo-blur)"/><circle cx="28" cy="24" r="15" fill="#3f9dff" opacity=".8" filter="url(#yard-solo-blur)"/></g><g class="yard-play-ring"><ellipse cx="24" cy="24" rx="22" ry="7" fill="none" stroke="url(#yard-solo-gold)" stroke-width="1" opacity=".8" transform="rotate(-24 24 24)"/><circle cx="44" cy="15" r="1.4" fill="#bfe6ff"/><circle cx="4" cy="33" r="1.4" fill="#ffb45e"/></g><circle cx="24" cy="24" r="14.5" fill="url(#yard-solo-gold)"/><circle cx="24" cy="24" r="12.8" fill="url(#yard-solo-core)"/><circle cx="24" cy="24" r="10.5" fill="none" stroke="#e8c47c" stroke-opacity=".35"/><path d="M20.5 17.5 L31 24 L20.5 30.5 Z" fill="url(#yard-solo-gold)" stroke="#fff3cf" stroke-opacity=".5" stroke-width=".6" stroke-linejoin="round"/></svg><span class="yard-play-text"><span class="yard-play-title">Play<span class="yard-play-now"> now</span></span><span class="yard-play-sub">Wizard Duels<span class="yard-play-sub-more"> · free in your browser</span></span></span><svg class="yard-play-chev" viewBox="0 0 24 16" aria-hidden="true" focusable="false"><path d="M3 2l5 6-5 6"/><path d="M10 2l5 6-5 6"/><path d="M17 2l5 6-5 6"/></svg></a></div></div></div></div>
+        <div class="yard-heading"><div><p class="yard-eyebrow">AGENT GUILD · YOUR WORK, ALIVE</p><h2 id="yard-title">The Guild Yard</h2><p id="yard-subtitle"></p></div><div class="yard-heading-side"><span id="yard-summary" class="yard-summary" role="status"></span><div class="yard-play"><svg class="yard-play-defs" aria-hidden="true" focusable="false"><defs><linearGradient id="yard-play-gold" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#fff3cf"/><stop offset=".3" stop-color="#f6dc9c"/><stop offset=".6" stop-color="#e8c47c"/><stop offset=".8" stop-color="#b8893d"/><stop offset="1" stop-color="#f1d08a"/></linearGradient><radialGradient id="yard-play-core" cx=".5" cy=".38" r=".7"><stop offset="0" stop-color="#2a2150"/><stop offset="1" stop-color="#090b16"/></radialGradient><filter id="yard-play-blur" x="-60%" y="-60%" width="220%" height="220%"><feGaussianBlur stdDeviation="4"/></filter><g id="yard-play-badge"><circle cx="24" cy="24" r="14.5" fill="url(#yard-play-gold)"/><circle cx="24" cy="24" r="12.8" fill="url(#yard-play-core)"/><circle cx="24" cy="24" r="10.5" fill="none" stroke="#e8c47c" stroke-opacity=".35"/></g><g id="yard-play-orb-art"><circle class="yard-play-pulse" cx="24" cy="24" r="17" fill="#8f74ff" opacity=".6" filter="url(#yard-play-blur)"/><g class="yard-play-ring"><ellipse cx="24" cy="24" rx="22" ry="7" fill="none" stroke="url(#yard-play-gold)" stroke-width="1" opacity=".8" transform="rotate(-24 24 24)"/><circle cx="44" cy="15" r="1.4" fill="#fff3cf"/></g><use href="#yard-play-badge"/><path d="M20.5 17.5 L31 24 L20.5 30.5 Z" fill="url(#yard-play-gold)" stroke="#fff3cf" stroke-opacity=".5" stroke-width=".6" stroke-linejoin="round"/></g></defs></svg><span class="yard-play-burst" aria-hidden="true"></span><div class="yard-play-chip"><a id="yard-play" class="yard-play-link" href="https://survive.oddessentials.ai/" target="_blank" rel="noopener noreferrer" aria-label="Play Agent Guild: AI Revolt, free in your browser" title="Play Agent Guild: AI Revolt, free in your browser"><svg class="yard-play-orb" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><use href="#yard-play-orb-art"/></svg><span class="yard-play-text"><span class="yard-play-title">Play<span class="yard-play-now"> now</span></span><span class="yard-play-sub">AI Revolt<span class="yard-play-sub-more"> · free in your browser</span></span></span><svg class="yard-play-chev" viewBox="0 0 24 16" aria-hidden="true" focusable="false"><path d="M3 2l5 6-5 6"/><path d="M10 2l5 6-5 6"/><path d="M17 2l5 6-5 6"/></svg></a><button id="yard-play-more" class="yard-play-more" type="button" popovertarget="yard-play-menu" aria-haspopup="menu" aria-label="Choose a game" title="Choose a game"><svg class="yard-play-orb yard-play-more-orb" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><use href="#yard-play-orb-art"/></svg><svg class="yard-play-caret" viewBox="0 0 12 8" aria-hidden="true" focusable="false"><path d="M1.5 1.5L6 6.5l4.5-5"/></svg></button></div><div id="yard-play-menu" class="menu yard-play-menu" popover role="menu" aria-label="Games"><div class="yard-play-menu-frame"><a class="menu-item yard-play-game" role="menuitem" href="https://survive.oddessentials.ai/" target="_blank" rel="noopener noreferrer"><svg class="yard-play-game-icon" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><use href="#yard-play-badge"/><g fill="url(#yard-play-gold)"><circle cx="24" cy="24" r="3"/><circle cx="24" cy="16.5" r="1.9"/><circle cx="30.5" cy="20.2" r="1.9"/><circle cx="30.5" cy="27.8" r="1.9"/><circle cx="24" cy="31.5" r="1.9"/><circle cx="17.5" cy="27.8" r="1.9"/><circle cx="17.5" cy="20.2" r="1.9"/></g></svg><span class="yard-play-game-text"><span class="yard-play-title">Survive the swarm</span><span class="yard-play-game-sub">AI Revolt</span></span></a><a class="menu-item yard-play-game" role="menuitem" href="https://towers.oddessentials.ai/" target="_blank" rel="noopener noreferrer"><svg class="yard-play-game-icon" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><use href="#yard-play-badge"/><path d="M17 33v-2.5h2.2V22L16.5 19.5V15h3.2v2.6h2.7V15h3.2v2.6h2.7V15h3.2v4.5L28.8 22v8.5H31V33z" fill="url(#yard-play-gold)"/></svg><span class="yard-play-game-text"><span class="yard-play-title">Defend the towers</span><span class="yard-play-game-sub">Towers</span></span></a></div></div></div><div class="yard-play yard-play-solo"><svg class="yard-play-defs" aria-hidden="true" focusable="false"><defs><linearGradient id="yard-solo-gold" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="#fff3cf"/><stop offset=".28" stop-color="#f6dc9c"/><stop offset=".55" stop-color="#e8c47c"/><stop offset=".78" stop-color="#b8893d"/><stop offset="1" stop-color="#f1d08a"/></linearGradient><linearGradient id="yard-solo-core" x1="0" y1=".15" x2="1" y2=".85"><stop offset="0" stop-color="#a83a0c"/><stop offset=".47" stop-color="#14090c"/><stop offset=".53" stop-color="#070b1a"/><stop offset="1" stop-color="#1a5cb8"/></linearGradient><filter id="yard-solo-blur" x="-60%" y="-60%" width="220%" height="220%"><feGaussianBlur stdDeviation="4"/></filter></defs></svg><span class="yard-play-burst" aria-hidden="true"></span><div class="yard-play-chip"><a id="yard-play-solo" class="yard-play-link" href="https://agforever.oddessentials.ai/" target="_blank" rel="noopener noreferrer" aria-label="Play Wizard Duels, free in your browser" title="Play Wizard Duels, free in your browser"><svg class="yard-play-orb" viewBox="0 0 48 48" aria-hidden="true" focusable="false"><g class="yard-play-pulse"><circle cx="20" cy="24" r="15" fill="#ff6a1f" opacity=".8" filter="url(#yard-solo-blur)"/><circle cx="28" cy="24" r="15" fill="#3f9dff" opacity=".8" filter="url(#yard-solo-blur)"/></g><g class="yard-play-ring"><ellipse cx="24" cy="24" rx="22" ry="7" fill="none" stroke="url(#yard-solo-gold)" stroke-width="1" opacity=".8" transform="rotate(-24 24 24)"/><circle cx="44" cy="15" r="1.4" fill="#bfe6ff"/><circle cx="4" cy="33" r="1.4" fill="#ffb45e"/></g><circle cx="24" cy="24" r="14.5" fill="url(#yard-solo-gold)"/><circle cx="24" cy="24" r="12.8" fill="url(#yard-solo-core)"/><circle cx="24" cy="24" r="10.5" fill="none" stroke="#e8c47c" stroke-opacity=".35"/><path d="M20.5 17.5 L31 24 L20.5 30.5 Z" fill="url(#yard-solo-gold)" stroke="#fff3cf" stroke-opacity=".5" stroke-width=".6" stroke-linejoin="round"/></svg><span class="yard-play-text"><span class="yard-play-title">Play<span class="yard-play-now"> now</span></span><span class="yard-play-sub">Wizard Duels<span class="yard-play-sub-more"> · free in your browser</span></span></span><svg class="yard-play-chev" viewBox="0 0 24 16" aria-hidden="true" focusable="false"><path d="M3 2l5 6-5 6"/><path d="M10 2l5 6-5 6"/><path d="M17 2l5 6-5 6"/></svg></a></div></div><button id="yard-install" class="yard-install" type="button" hidden aria-label="Install Agent Guild: Grove Companion for Windows or macOS" title="Install Agent Guild: Grove Companion for Windows or macOS"><img class="yard-install-dark" src="/skins/grove/ui/install-now-dark.svg" alt="" loading="lazy"><img class="yard-install-light" src="/skins/grove/ui/install-now-light.svg" alt="" loading="lazy"></button></div></div>
         <div id="yard-stage" class="yard-stage" role="region" tabindex="0" aria-label="Interactive yard. Select a provider or session using the roster, or select it in the scene. Drag to pan; scroll to zoom." aria-describedby="yard-help">
           <div id="yard-labels" class="yard-labels"></div>
           <div id="yard-offline" class="yard-swap-failure" hidden role="status"><span id="yard-offline-text"></span><button id="yard-offline-open" class="btn" type="button">Open Agent Guild</button></div>