@oddessentials/agent-guild 1.4.0 → 1.6.0

package/README.md

@@ -12,27 +12,24 @@
   <a href="https://oddessentials.ai/donate/?ref=agent-guild"><img src="https://img.shields.io/badge/support-buy%20the%20lab%20a%20beer-f2a93b" alt="Support Agent Guild: buy the lab a beer"></a>
 </p>
 
+<p align="center">
+  <picture>
+    <source media="(prefers-reduced-motion: reduce)" srcset="docs/images/yard-still.webp">
+    <img src="docs/images/yard-clip.webp" alt="Seven coding-agent sessions as characters in the Guild Yard: they leave the plaza for their tools' halls and get to work, then a double-click on one opens Claude Code's real terminal, with its three helper agents" width="100%">
+  </picture>
+</p>
+
+**Every coding agent you run becomes a character in a 3D world, and stays a
+real terminal one double-click away.**
+
 **Agent Guild** runs Claude Code, Codex CLI, Antigravity CLI, Grok Build,
 Docker Agent and your own shell side by side, in real terminals, from one
-local web page.
+local web page, or from your phone over Tailscale.
 Close the page whenever you like; the sessions keep running.
 
 [Try the demo](https://oddessentials.github.io/agent-guild/) in your browser
 (simulated, nothing installed) or [watch the trailer](https://www.youtube.com/watch?v=ziT62WtXQ1M).
 
-**[Agent Guild: World](https://agentguild.oddessentials.ai/)**, coming soon to
-Steam, shows the same sessions as a crew at work in a living 3D world, on
-Windows, macOS and Linux. It runs on Agent Guild, which stays free.
-
-**[Agent Guild for VS Code](https://marketplace.visualstudio.com/items?itemName=OddEssentials.agent-guild)**
-opens the same page in an editor tab. Editors that install from Open VSX get it
-[there](https://open-vsx.org/extension/OddEssentials/agent-guild).
-
-<picture>
-  <source media="(prefers-color-scheme: light)" srcset="docs/images/overview-light.webp">
-  <img src="docs/images/overview-dark.webp" alt="Agent Guild with one card per coding tool and six sessions at work">
-</picture>
-
 ## Quick start
 
 With Node.js 22 or newer:
@@ -46,6 +43,10 @@ The page opens in your browser. Press **New** on a tool's card to start a
 session. Sign in to each tool inside its first session, as you would in any
 terminal.
 
+**[Agent Guild for VS Code](https://marketplace.visualstudio.com/items?itemName=OddEssentials.agent-guild)**
+opens the same page in an editor tab. Editors that install from Open VSX get it
+[there](https://open-vsx.org/extension/OddEssentials/agent-guild).
+
 | Requirement | |
 | --- | --- |
 | Node.js | 22 or newer |
@@ -56,23 +57,18 @@ terminal.
 No compiler is needed, except on Linux without glibc, such as Alpine:
 `agent-guild` prints the commands that build its terminal library there. A
 missing tool shows **Install** on its card; Antigravity CLI, which is not on
-npm, shows its install command instead. Docker Agent is the `docker agent`
-plugin; Docker Desktop 4.63 and later ship it, and its card's **Install**
-downloads the latest release into `~/.docker/cli-plugins` when no copy runs.
-The card's installation box lists every copy the Docker CLI finds and which
-one runs; the card updates and removes only the downloaded one, and leaves
-Docker Desktop's to Desktop.
+npm, shows its install command instead. For Docker Agent, see
+[Docker Agent](#docker-agent).
 
-On Linux, Docker Engine does not include the plugin; the card's **Install**
-adds it. The card needs Docker's own `docker` command: Podman's
-`docker` and the Ubuntu snap of Docker do not load the plugin. If you
-installed Docker Agent on its own as `docker-agent` (Homebrew or a release
-download), add this to [`providers.json`](docs/configuration.md#providersjson),
-then run `agent-guild restart`:
+<picture>
+  <source media="(prefers-color-scheme: light)" srcset="docs/images/overview-light.webp">
+  <img src="docs/images/overview-dark.webp" alt="Agent Guild with one card per coding tool and six sessions at work">
+</picture>
 
-```json
-{ "providers": [{ "id": "docker", "command": "docker-agent", "args": ["run"], "versionArgs": ["version"] }] }
-```
+**[Agent Guild: World](https://agentguild.oddessentials.ai/)**, coming soon to
+Steam, is the premium 3D window onto the same sessions: six worlds to roam
+with a free camera, Steam Workshop crews and companions, and controller
+support, on Windows, macOS and Linux. Agent Guild and its Yard stay free.
 
 ## Setup
 
@@ -86,6 +82,25 @@ To replace it, stop the manager (this ends running sessions), delete
 `auth-token` from the [data folder](docs/configuration.md#data-folder), and
 start again.
 
+### Docker Agent
+
+Docker Agent is the `docker agent` plugin; Docker Desktop 4.63 and later ship
+it, and its card's **Install** downloads the latest release into
+`~/.docker/cli-plugins` when no copy runs. The card's installation box lists
+every copy the Docker CLI finds and which one runs; the card updates and
+removes only the downloaded one, and leaves Docker Desktop's to Desktop.
+
+On Linux, Docker Engine does not include the plugin; the card's **Install**
+adds it. The card needs Docker's own `docker` command: Podman's
+`docker` and the Ubuntu snap of Docker do not load the plugin. If you
+installed Docker Agent on its own as `docker-agent` (Homebrew or a release
+download), add this to [`providers.json`](docs/configuration.md#providersjson),
+then run `agent-guild restart`:
+
+```json
+{ "providers": [{ "id": "docker", "command": "docker-agent", "args": ["run"], "versionArgs": ["version"] }] }
+```
+
 ### Headless Linux server
 
 1. On the server:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddessentials/agent-guild",
-  "version": "1.4.0",
+  "version": "1.6.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.",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {

package/src/manager/github-views.mjs

@@ -1,9 +1,11 @@
-// Branches, Issues, Actions runs and open pull requests of one repository, read with a
-// signed-in account. Reading and editing stay shallow: GitHub's page is the full view.
+// Branches, Issues, Actions runs, open pull requests and the account's own recent work in one
+// repository, read with a signed-in account. Reading and editing stay shallow: GitHub's page is the full view.
 
 import { nextLink, parseRepo } from './github.mjs';
 
 const PAGE = 30;
+const ACTIVITY_PAGES = 3;
+const CLOSERS = 20;
 const RUNNING = new Set(['queued', 'in_progress', 'waiting', 'requested', 'pending']);
 const WEB = 'https://github.com';
 const ISSUE_RE = /^[1-9]\d{0,9}$/;
@@ -16,6 +18,16 @@ function refusal(status, code, message) {
   return Object.assign(new Error(message), { status, code });
 }
 
+/** GitHub's own refusals become answers the page can show as they are. */
+function requestError(err, account, repo) {
+  if (err.limited) return refusal(429, 'rate_limited', err.message);
+  if (err.github === 404) return refusal(404, 'not_found', `GitHub could not find ${repo.fullName} for @${account.login}`);
+  if (err.github === 410) return refusal(404, 'issues_disabled', `Issues are turned off for ${repo.fullName}`);
+  if (err.github === 403) return refusal(403, 'forbidden', `GitHub did not let @${account.login} do that in ${repo.fullName}`);
+  if (err.github === 422) return refusal(400, 'github_rejected', err.message);
+  return err;
+}
+
 /** A github.com page, or the fallback built from checked parts. */
 export function githubUrl(value, fallback) {
   try {
@@ -86,6 +98,40 @@ function cleanPull(raw, fullName) {
   };
 }
 
+function idOf(user) {
+  return Number.isSafeInteger(user?.id) ? user.id : null;
+}
+
+function since(value, from) {
+  const at = Date.parse(value);
+  return Number.isFinite(at) && at >= from;
+}
+
+function cleanMerged(raw, fullName) {
+  const number = raw?.number;
+  if (!Number.isSafeInteger(number) || number < 1) return null;
+  return {
+    repo: fullName,
+    number,
+    title: text(raw.title, 256).trim(),
+    mergedAt: time(raw.merged_at),
+    url: githubUrl(raw.html_url, `${WEB}/${fullName}/pull/${number}`),
+  };
+}
+
+function cleanPassed(raw, fullName) {
+  const id = raw?.id;
+  if (!Number.isSafeInteger(id) || id < 1) return null;
+  return {
+    id,
+    name: text(raw.name, 200) || 'Workflow',
+    branch: text(raw.head_branch, 200),
+    event: text(raw.event, 40),
+    createdAt: time(raw.created_at),
+    url: githubUrl(raw.html_url, `${WEB}/${fullName}/actions/runs/${id}`),
+  };
+}
+
 /** The Actions part of a githubstatus.com summary: null while it is operational or unreadable. */
 export function actionsService(summary) {
   const component = (Array.isArray(summary?.components) ? summary.components : []).find((c) => c?.name === 'Actions' && !c.group_id);
@@ -127,7 +173,7 @@ export function createViews(github, { now = Date.now } = {}) {
     return read;
   }
 
-  /** One request for the repository's account. GitHub's own refusals become answers the page can show as they are. */
+  /** One request for the repository's account. */
   async function call(accountId, owner, name, route, init) {
     const account = github.account(accountId);
     const repo = parseRepo(`${owner ?? ''}/${name ?? ''}`);
@@ -135,13 +181,21 @@ export function createViews(github, { now = Date.now } = {}) {
       const { body, res } = await github._apiJson(account, `/repos/${repo.owner}/${repo.name}${route}`, init);
       return { body, res, repo };
     } catch (err) {
-      if (err.limited) throw refusal(429, 'rate_limited', err.message);
-      if (err.github === 404) throw refusal(404, 'not_found', `GitHub could not find ${repo.fullName} for @${account.login}`);
-      if (err.github === 410) throw refusal(404, 'issues_disabled', `Issues are turned off for ${repo.fullName}`);
-      if (err.github === 403) throw refusal(403, 'forbidden', `GitHub did not let @${account.login} do that in ${repo.fullName}`);
-      if (err.github === 422) throw refusal(400, 'github_rejected', err.message);
-      throw err;
+      throw requestError(err, account, repo);
+    }
+  }
+
+  /** A listing's pages, newest first, until one reaches back before `from`, GitHub has no more, or ACTIVITY_PAGES are read. */
+  async function recent(accountId, owner, name, route, stamp, from, items = (body) => body) {
+    const found = [];
+    for (let page = 1; page <= ACTIVITY_PAGES; page++) {
+      const { body, res } = await call(accountId, owner, name, `${route}&per_page=100&page=${page}`);
+      const list = items(body);
+      if (!Array.isArray(list)) throw refusal(502, 'github_error', 'GitHub did not return a list');
+      found.push(...list);
+      if (!nextLink(res.headers.get('link')) || list.some((item) => !since(stamp(item), from))) return { found, truncated: false };
     }
+    return { found, truncated: true };
   }
 
   return {
@@ -235,5 +289,75 @@ export function createViews(github, { now = Date.now } = {}) {
         url: `${WEB}/${repo.fullName}/pulls`,
       };
     },
+
+    /** The account's own merged pull requests, issues closed as completed and successful runs, from `from` on. */
+    async activity(accountId, owner, name, { from: value } = {}) {
+      const from = typeof value === 'string' && /^\d{4}-\d{2}-\d{2}T/.test(value) ? Date.parse(value) : NaN;
+      if (!Number.isFinite(from)) throw refusal(400, 'bad_since', 'since must be a time such as 2026-10-01T00:00:00Z');
+      const account = github.account(accountId);
+      const repo = parseRepo(`${owner ?? ''}/${name ?? ''}`);
+      // The actor filter needs the current login; ownership is still checked by numeric id.
+      await github._refreshUser(account).catch((err) => { throw requestError(err, account, repo); });
+      const stamp = new Date(from).toISOString().replace(/\.\d{3}Z$/, 'Z');
+      let truncated = false;
+      const merged = new Map();
+      const closedPulls = '/pulls?state=closed&sort=updated&direction=desc';
+      const mergeFrom = (list, fullName, head) => {
+        for (const pull of list) {
+          if (idOf(pull?.user) !== account.id || !since(pull.merged_at, from)) continue;
+          if (head !== null && (!Number.isSafeInteger(head) || pull.head?.repo?.id !== head)) continue;
+          const clean = cleanMerged(pull, fullName);
+          if (clean) merged.set(`${fullName.toLowerCase()}#${clean.number}`, clean);
+        }
+      };
+
+      const { body: metadata } = await call(accountId, repo.owner, repo.name, '');
+      const own = await recent(accountId, repo.owner, repo.name, closedPulls, (p) => p?.updated_at, from);
+      truncated ||= own.truncated;
+      mergeFrom(own.found, repo.fullName, null);
+      let parent = null;
+      try { parent = metadata?.fork === true ? parseRepo(metadata.parent?.full_name) : null; } catch { /* not a fork we can read */ }
+      if (parent) {
+        try {
+          const upstream = await recent(accountId, parent.owner, parent.name, closedPulls, (p) => p?.updated_at, from);
+          truncated ||= upstream.truncated;
+          mergeFrom(upstream.found, parent.fullName, metadata.id ?? NaN);
+        } catch (err) {
+          if (err.code !== 'not_found') throw err;
+        }
+      }
+
+      const closed = new Map();
+      try {
+        const listed = await recent(accountId, repo.owner, repo.name, `/issues?state=closed&sort=updated&direction=desc&since=${stamp}`, (i) => i?.updated_at, from);
+        const candidates = listed.found.filter((i) => i && !i.pull_request && i.state_reason === 'completed' && since(i.closed_at, from) && ISSUE_RE.test(String(i.number)));
+        truncated ||= listed.truncated || candidates.length > CLOSERS;
+        for (const candidate of candidates.slice(0, CLOSERS)) {
+          // GitHub's docs promise closed_by only on the issue itself, so a listing without it is read again.
+          const issue = candidate.closed_by !== undefined ? candidate : await call(accountId, repo.owner, repo.name, `/issues/${candidate.number}`).then(({ body }) => body, (err) => {
+            if (err.code === 'not_found') return null;
+            throw err;
+          });
+          if (issue?.state !== 'closed' || issue.state_reason !== 'completed' || idOf(issue.closed_by) !== account.id || !since(issue.closed_at, from)) continue;
+          const clean = cleanIssue(issue, repo.fullName);
+          if (clean) closed.set(clean.number, { number: clean.number, title: clean.title, closedAt: time(issue.closed_at), url: clean.url });
+        }
+      } catch (err) {
+        if (err.code !== 'issues_disabled') throw err;
+      }
+
+      const runs = await recent(accountId, repo.owner, repo.name,
+        `/actions/runs?actor=${encodeURIComponent(account.login)}&status=success&created=${encodeURIComponent(`>=${stamp}`)}`,
+        (r) => r?.created_at, from, (body) => body?.workflow_runs);
+      truncated ||= runs.truncated;
+      const passed = new Map();
+      for (const run of runs.found) {
+        if (idOf(run?.actor) !== account.id || run.conclusion !== 'success' || !since(run.created_at, from)) continue;
+        const clean = cleanPassed(run, repo.fullName);
+        if (clean) passed.set(clean.id, clean);
+      }
+
+      return { since: new Date(from).toISOString(), merged: [...merged.values()], closed: [...closed.values()], passed: [...passed.values()], truncated };
+    },
   };
 }

package/src/manager/github.mjs

@@ -780,6 +780,7 @@ export class GitHub extends EventEmitter {
     if (body?.id === account.id && typeof body.login === 'string' && body.login !== account.login) {
       account.login = body.login;
       this._save();
+      this._changed();
     }
   }
 

package/src/manager/remote-access.mjs

@@ -26,6 +26,7 @@ function validateSaved(value) {
   if (!value || value.version !== 1 || typeof value.revision !== 'string' || value.revision.length > 100
     || !['off', 'custom', 'tailscale'].includes(value.mode)) throw new Error('Unsupported remote-access settings.');
   const route = value.route ? validateRoute(value.route) : null;
+  const lastRoute = value.lastRoute ? validateRoute(value.lastRoute) : null;
   if (value.mode === 'tailscale' && !route) throw new Error('Missing saved Tailscale route.');
   if (value.mode !== 'tailscale' && route) throw new Error('Unexpected saved Tailscale route.');
   const access = value.mode === 'off' ? emptyAccess() : value.mode === 'tailscale' ? routeAccess(route) : normalizeAccess(value.access);
@@ -34,7 +35,7 @@ function validateSaved(value) {
     if (!['enable', 'disable'].includes(value.pending.type)) throw new Error('Invalid pending remote-access operation.');
     pending = { type: value.pending.type, route: validateRoute(value.pending.route), ...(value.pending.previous ? { previous: validateRoute(value.pending.previous) } : {}) };
   }
-  return { version: 1, revision: value.revision, mode: value.mode, access, route, pending };
+  return { version: 1, revision: value.revision, mode: value.mode, access, route, lastRoute, pending };
 }
 
 export function loadRemoteAccess(file, env = process.env) {
@@ -56,7 +57,7 @@ export function loadRemoteAccess(file, env = process.env) {
 }
 
 function disabledConfig() {
-  return { version: 1, revision: randomUUID(), mode: 'off', access: emptyAccess(), route: null, pending: null };
+  return { version: 1, revision: randomUUID(), mode: 'off', access: emptyAccess(), route: null, lastRoute: null, pending: null };
 }
 
 export function saveRemoteAccess(file, config) {
@@ -122,13 +123,25 @@ export class RemoteAccess extends EventEmitter {
     this.getTarget = getTarget;
   }
 
+  /** The route enabling would use: the remembered one unless `standard` asks for the usual order. */
+  select(info, previous, standard = false) {
+    return chooseRoute(info, this.getTarget(), previous, standard ? null : this.config.lastRoute);
+  }
+
   snapshot() {
     const config = this.config;
     let candidate = null;
     if (this.info && !this.busy && this.getTarget()) {
       try {
-        const route = chooseRoute(this.info, this.getTarget(), config.pending?.type === 'enable' ? config.pending.route : config.route);
-        candidate = { url: routeUrl(route), existing: !config.route && !config.pending && routeMatches(this.info.config, route) };
+        const previous = config.pending?.type === 'enable' ? config.pending.route : config.route;
+        const route = this.select(this.info, previous);
+        const fresh = !config.route && !config.pending;
+        const existing = fresh && routeMatches(this.info.config, route);
+        candidate = { url: routeUrl(route), existing, remembered: fresh && !existing && Boolean(config.lastRoute) && routeUrl(config.lastRoute) === routeUrl(route) };
+        if (fresh) {
+          const standard = routeUrl(this.select(this.info, null, true));
+          if (standard !== candidate.url) candidate.standardUrl = standard;
+        }
       } catch {}
     }
     return {
@@ -201,6 +214,9 @@ export class RemoteAccess extends EventEmitter {
     if (this.busy) throw remoteError('remote_busy', 'A remote-access operation is already in progress.');
     if (body.revision !== this.config.revision) throw remoteError('stale_settings', 'Remote access changed in another tab. Review the current settings and try again.');
     if (!['enable', 'disable', 'custom', 'forget'].includes(body.action)) throw remoteError('bad_action', 'Choose a valid remote-access action.', 400);
+    if (body.standard !== undefined && (body.standard !== true || body.action !== 'enable' || this.config.route || this.config.pending)) {
+      throw remoteError('bad_action', 'Switch to the standard address while remote access is off.', 400);
+    }
     let access;
     if (body.action === 'custom') {
       if (this.config.route || this.config.pending) throw remoteError('disable_first', 'Disable the Tailscale connection before changing custom proxy settings.');
@@ -214,7 +230,7 @@ export class RemoteAccess extends EventEmitter {
     this.connection = null;
     this.publish();
     this.task = Promise.resolve().then(async () => {
-      if (body.action === 'enable') await this.enable(body.adopt === true);
+      if (body.action === 'enable') await this.enable(body.adopt === true, body.standard === true);
       else if (body.action === 'disable') await this.disable();
       else if (body.action === 'custom') this.persist({ ...this.config, mode: access.hosts.length || access.origins.length ? 'custom' : 'off', access, route: null, pending: null });
       else this.persist({ ...this.config, pending: null });
@@ -227,13 +243,13 @@ export class RemoteAccess extends EventEmitter {
     return this.snapshot();
   }
 
-  async enable(adopt) {
+  async enable(adopt, standard = false) {
     if (this.config.pending?.type === 'disable') throw remoteError('cleanup_required', 'Finish cleanup of the previous route before enabling remote access.');
     const info = await this.tailscale.inspect({ signal: this.abort.signal });
     this.info = info;
     let previous = this.config.pending?.type === 'enable' ? this.config.pending.route : this.config.route;
     let route;
-    try { route = chooseRoute(info, this.getTarget(), previous); } catch (error) {
+    try { route = this.select(info, previous, standard); } catch (error) {
       const fallback = this.config.pending?.previous || this.config.route;
       if (!fallback || !routeMatches(info.config, fallback)) throw error;
       previous = fallback;
@@ -264,7 +280,7 @@ export class RemoteAccess extends EventEmitter {
   async disable() {
     const route = this.config.pending?.route || this.config.route;
     const previous = this.config.pending?.previous || this.config.route;
-    this.persist({ ...this.config, mode: 'off', access: emptyAccess(), route: null, pending: route ? { type: 'disable', route, ...(previous ? { previous } : {}) } : null });
+    this.persist({ ...this.config, mode: 'off', access: emptyAccess(), route: null, lastRoute: this.config.route || this.config.lastRoute, pending: route ? { type: 'disable', route, ...(previous ? { previous } : {}) } : null });
     if (route) {
       try {
         const info = await this.tailscale.inspect({ signal: this.abort.signal });

package/src/manager/server.mjs

@@ -587,7 +587,7 @@ export function createManagerServer({
       const folder = manager.resolveCwd(url.searchParams.get('cwd'));
       return sendJson(res, 200, { folder, repo: folderOrigin(folder) });
     }
-    const view = route.match(/^\/github\/accounts\/([^/]+)\/repos\/([^/]+)\/([^/]+)\/(issues|actions|pulls|branches)(?:\/([^/]+))?$/);
+    const view = route.match(/^\/github\/accounts\/([^/]+)\/repos\/([^/]+)\/([^/]+)\/(issues|actions|pulls|branches|activity)(?:\/([^/]+))?$/);
     if (view) {
       let parts;
       try { parts = view.map((part) => (part === undefined ? part : decodeURIComponent(part))); } catch { throw new HttpError(400, 'repo must be a GitHub repository written as owner/name', 'bad_repo'); }
@@ -604,6 +604,7 @@ export function createManagerServer({
       if (kind === 'branches' && number === undefined && method === 'GET') return sendJson(res, 200, await views.branches(id, owner, name, { page: url.searchParams.get('page') ?? '1' }));
       if (kind === 'actions' && number === undefined && method === 'GET') return sendJson(res, 200, await views.actions(id, owner, name));
       if (kind === 'pulls' && number === undefined && method === 'GET') return sendJson(res, 200, await views.pulls(id, owner, name));
+      if (kind === 'activity' && number === undefined && method === 'GET') return sendJson(res, 200, await views.activity(id, owner, name, { from: url.searchParams.get('since') }));
     }
     const match = route.match(/^\/github\/accounts\/([^/]+)(\/repos|\/ssh)?$/);
     if (match) {

package/src/manager/tailscale.mjs

@@ -121,7 +121,7 @@ export function routeMatches(config, route) {
   } catch { return false; }
 }
 
-export function chooseRoute(info, target, previous = null) {
+export function chooseRoute(info, target, previous = null, remembered = null) {
   if (previous) {
     if (previous.nodeId !== info.nodeId || previous.host !== info.host) {
       throw remoteError('network_changed', 'This computer’s Tailscale identity or address changed. Disable the saved connection before setting up the new address.');
@@ -136,6 +136,9 @@ export function chooseRoute(info, target, previous = null) {
     const route = { nodeId: info.nodeId, host: info.host, port, target };
     if (Number.isInteger(port) && port > 0 && port <= 65535 && routeMatches(info.config, route)) return route;
   }
+  if (remembered?.nodeId === info.nodeId && remembered.host === info.host && !portOccupied(info.config, remembered.port)) {
+    return { nodeId: info.nodeId, host: info.host, port: remembered.port, target };
+  }
   const port = [443, ...Array.from({ length: 32 }, (_, i) => 8443 + i)].find((candidate) => !portOccupied(info.config, candidate));
   if (!port) throw remoteError('no_port', 'No available HTTPS port was found. Free a Serve port in Tailscale and try again.');
   return { nodeId: info.nodeId, host: info.host, port, target };

package/web/app.js

@@ -14,7 +14,7 @@ import { createReader } from './read-aloud.js';
 import { matchFolders, readRecentFolders, rememberFolder } from './folders.js';
 import { initYard } from './yard/view.js';
 import { ask } from './ask.js';
-import { framed, openLink, announceReady, copyToClipboard, onViewRequest } from './host.js';
+import { framed, compact, openLink, announceReady, expand, copyToClipboard, onViewRequest, onSessionRequest } from './host.js';
 
 const TOKEN_KEY = 'agentGuild.token';
 const CWD_KEY = 'agentGuild.cwd';
@@ -7069,7 +7069,7 @@ function savePanes() {
 }
 
 function restorePanes() {
-  if (panesRestored) return;
+  if (panesRestored || compact) return;
   panesRestored = true;
   let saved;
   try { saved = JSON.parse(load(PANES_KEY)); } catch { return; }
@@ -7519,8 +7519,9 @@ function connectEvents() {
       managerConnected(msg);
       state.environmentUI?.connected(msg.pid);
       renderSessions();
-      if (!sessionsShown && load(DOCK_KEY) === 'github' && !dockView.panel) openGitHub({ focus: false });
+      if (!sessionsShown && !compact && load(DOCK_KEY) === 'github' && !dockView.panel) openGitHub({ focus: false });
       restorePanes();
+      openAskedSession();
       sessionsShown = true;
       renderEmpty();
       setUpgrade(msg.upgrade, true);
@@ -7559,6 +7560,7 @@ function connectEvents() {
       managerGone();
     } else if (msg.type === 'session.created' || msg.type === 'session.updated') {
       upsertSession(msg.session);
+      openAskedSession();
     } else if (msg.type === 'session.removed') {
       dropSession(msg.sessionId);
     } else if (msg.type === 'providers.updated') {
@@ -7663,8 +7665,9 @@ function readTokenFromHash() {
   const params = new URLSearchParams(location.hash.slice(1));
   const token = params.get('token');
   if (token) {
-    // Keep the token out of the address bar and browser history.
-    history.replaceState(null, '', location.pathname + location.search);
+    // Keep the token out of the address bar and browser history. A compact page keeps the rest, which it does not save.
+    params.delete('token');
+    history.replaceState(null, '', location.pathname + location.search + (compact ? `#${params}` : ''));
   }
   return token;
 }
@@ -7707,7 +7710,7 @@ async function boot() {
   }
   save(TOKEN_KEY, state.token);
   $('app').hidden = false;
-  if (load(DOCK_KEY) === 'notes' && !dockView.panel) openNotes({ focus: false });
+  if (!compact && load(DOCK_KEY) === 'notes' && !dockView.panel) openNotes({ focus: false });
   connectEvents();
   loadUsage();
   clearInterval(usageTimer);
@@ -8198,7 +8201,7 @@ renderVoice();
 renderRead();
 // Follow the system setting until the user picks a theme.
 window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', (e) => {
-  if (!load(THEME_KEY)) applyTheme(e.matches ? 'dark' : 'light');
+  if (!compact && !load(THEME_KEY)) applyTheme(e.matches ? 'dark' : 'light');
 });
 $('panel-stop').addEventListener('click', () => {
   const s = state.sessions.get(state.activeId);
@@ -8299,10 +8302,12 @@ yardUi = initYard({
     providers: state.providers,
     sessions: [...state.sessions.values()],
     connected: state.connected,
+    retrying: state.eventsRetry > 0,
     news: state.news,
     activeId: state.activeId,
   }),
-  openSession: openPanel,
+  openSession: compact ? expand : openPanel,
+  expand: compact ? () => expand() : null,
   openNews,
   selected: dockMakesWayForYard,
   yardArt: () => state.yardArt,
@@ -8356,6 +8361,17 @@ onViewRequest((view) => {
   if (!$('terminal-panel').hidden) closePanel();
   yardUi.setView(view);
 });
+let askedSession = null;
+function openAskedSession() {
+  if (!askedSession || !state.sessions.has(askedSession)) return;
+  const id = askedSession;
+  askedSession = null;
+  openPanel(id);
+}
+onSessionRequest((id) => {
+  askedSession = id;
+  if (state.connected && state.eventsSocket?.greeted) openAskedSession();
+});
 
 state.token = readTokenFromHash() || load(TOKEN_KEY);
 boot();

package/web/host.js

@@ -5,6 +5,7 @@
 export const framed = typeof window !== 'undefined' && window.parent !== window;
 const app = typeof window !== 'undefined' && !framed ? window.webkit?.messageHandlers?.agentGuild ?? null : null;
 const hosted = framed || Boolean(app);
+export const compact = hosted && document.documentElement?.dataset.layout === 'compact';
 
 function post(message) {
   // The manager's frame-ancestors lets only VS Code webviews frame the page.
@@ -35,20 +36,37 @@ export function announceReady(version) {
   if (hosted) post({ type: 'ready', version });
 }
 
+export function expand(session) {
+  if (hosted) post(session ? { type: 'expand', session } : { type: 'expand' });
+}
+
 let showView = null;
+let showSession = null;
 
 export function onViewRequest(callback) {
   showView = callback;
 }
 
+export function onSessionRequest(callback) {
+  showSession = callback;
+}
+
 if (hosted) {
   // The app posts its request into the page itself, so a subframe such as the video player cannot pass for it.
   const [sender, expected] = framed ? [window.parent, 'agent-guild-vscode'] : [window, 'agent-guild-app'];
   window.addEventListener('message', (event) => {
     if (event.source !== sender || (app && event.origin !== location.origin)) return;
-    const { source, type, view } = event.data ?? {};
-    if (source === expected && type === 'view' && (view === 'cards' || view === 'yard')) showView?.(view);
+    const { source, type, view, id } = event.data ?? {};
+    if (source !== expected) return;
+    if (type === 'view' && (view === 'cards' || view === 'yard')) showView?.(view);
+    if (type === 'session' && typeof id === 'string') showSession?.(id);
   });
+  if (framed && !compact) {
+    const root = document.documentElement;
+    const look = () => post({ type: 'look', skin: root.dataset.skin, theme: root.dataset.theme });
+    new MutationObserver(look).observe(root, { attributes: true, attributeFilter: ['data-skin', 'data-theme'] });
+    look();
+  }
   const follow = (event) => {
     if (event.button > 1) return;
     const link = event.target.closest?.('a[target="_blank"][href]');

package/web/index.html

@@ -132,6 +132,7 @@
           <div id="yard-labels" class="yard-labels"></div>
           <div id="yard-loading" class="yard-loading" role="status" data-mode="scene"><span id="yard-loading-text">Preparing your yard…</span><span id="yard-loading-size" class="yard-loading-size" aria-hidden="true"></span><span class="yard-loading-bar" aria-hidden="true"></span></div>
           <div id="yard-swap-failure" class="yard-swap-failure" hidden role="status"><span id="yard-swap-failure-text"></span><button id="yard-swap-retry" class="btn" type="button">Retry</button></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>
           <div id="yard-failure" class="yard-failure" hidden role="status"><strong>The 3D view is unavailable</strong><p>You can still use every action in the roster and inspector.</p><button id="yard-retry" class="btn" type="button">Retry 3D</button><button id="yard-cards" class="btn" type="button">Show Cards</button></div>
           <div id="yard-download" class="yard-failure yard-download" hidden role="region" aria-labelledby="yard-download-title"><strong id="yard-download-title" role="status"></strong><p id="yard-download-text"></p><progress id="yard-download-progress" aria-labelledby="yard-download-title"></progress><span id="yard-download-size" class="yard-loading-size"></span><div class="yard-download-actions"><button id="yard-download-cancel" class="btn" type="button">Cancel</button><button id="yard-download-retry" class="btn" type="button" hidden>Retry</button><button id="yard-download-cards" class="btn" type="button">Show Cards</button></div></div>
           <div class="yard-camera" role="group" aria-label="Camera"><button id="yard-zoom-in" type="button" class="btn" aria-label="Zoom in">+</button><button id="yard-zoom-out" type="button" class="btn" aria-label="Zoom out">−</button><button id="yard-fit" type="button" class="btn">Overview</button><button id="yard-focus" type="button" class="btn" disabled>Focus selected</button></div>
@@ -390,6 +391,17 @@
         <p id="remote-status-text"></p>
       </div>
       <p id="remote-error" class="remote-error" role="alert" hidden></p>
+      <div id="remote-next-row" hidden>
+        <p id="remote-next" class="sub"></p>
+        <button id="remote-standard" class="btn" type="button" hidden>Switch to standard address</button>
+      </div>
+      <div id="remote-standard-confirm" class="remote-confirm" hidden>
+        <p id="remote-standard-text"></p>
+        <div class="remote-actions">
+          <button id="remote-standard-yes" class="btn primary" type="button">Switch to standard address</button>
+          <button id="remote-standard-no" class="btn" type="button">Keep previous address</button>
+        </div>
+      </div>
       <div id="remote-address-row" hidden>
         <label for="remote-address">Your remote address</label>
         <input id="remote-address" class="remote-address" readonly spellcheck="false">
@@ -398,6 +410,7 @@
           <button id="remote-copy-address" class="btn" type="button">Copy address</button>
           <a id="remote-open-address" class="btn" target="_blank" rel="noopener noreferrer">Open</a>
         </div>
+        <p id="remote-port-note" class="sub" hidden>To use the standard address, disable remote access, then choose Switch to standard address.</p>
       </div>
       <div id="remote-share" class="remote-share" hidden>
         <p>Connect the other device to Tailscale, then scan this code or open the sign-in link.</p>