@oddessentials/agent-guild 1.21.1 → 1.22.0

package/src/manager/providers.mjs

@@ -22,6 +22,7 @@ import { MultiplexerRegistry } from './multiplexers.mjs';
 import { reconcileHerdrPath } from './multiplexer-paths.mjs';
 import { refreshLaunchers } from './launchers.mjs';
 import { LaunchFlags, normalizeLaunchFlags } from './launch-flags.mjs';
+import { MCP_MODES } from './mcp-connect.mjs';
 
 const here = path.dirname(fileURLToPath(import.meta.url));
 export const DEFAULTS_FILE = path.resolve(here, '../../config/providers.default.json');
@@ -87,6 +88,8 @@ function normalizeChannels(raw) {
       remove: stringList(raw.native.remove),
       links: stringList(raw.native.links),
       sharedWithNpm: raw.native.sharedWithNpm === true,
+      reinstall: raw.native.reinstall === true,
+      versionEnv: typeof raw.native.versionEnv === 'string' && /^[A-Za-z_][A-Za-z0-9_]*$/.test(raw.native.versionEnv) ? raw.native.versionEnv : null,
     };
   }
   if (raw.brew && typeof raw.brew === 'object') out.brew = { names: stringList(raw.brew.names), autoUpdates: raw.brew.autoUpdates === true };
@@ -171,6 +174,7 @@ function normalize(raw, platform, warnings) {
     memory: ['claude', 'codex', 'grok'].includes(merged.memory) ? merged.memory : null,
     instructions: ['claude', 'codex', 'grok', 'google'].includes(merged.instructions) ? merged.instructions : null,
     reporting: REPORTING_MODES.has(merged.reporting) ? merged.reporting : null,
+    mcp: MCP_MODES.includes(merged.mcp) ? merged.mcp : null,
     modelPattern: merged.modelPattern ? String(merged.modelPattern) : null,
     args: Array.isArray(merged.args) ? merged.args.map(String) : [],
     resumeArgs: Array.isArray(merged.resumeArgs) ? merged.resumeArgs.map(String) : [],
@@ -308,6 +312,7 @@ export class ProviderRegistry extends EventEmitter {
     this._npmRegistry = null;
     this.reportingEnabled = null;
     this.reportingNote = null;
+    this.mcpState = null;
     this.multiplexers = new MultiplexerRegistry(this, multiplexerOptions);
     this.multiplexerState = null;
     this.reload();
@@ -585,6 +590,16 @@ export class ProviderRegistry extends EventEmitter {
     return args;
   }
 
+  reinstalls(provider) {
+    return Boolean(!provider.plugin && !provider.package && provider.install && provider.channels.native?.reinstall);
+  }
+
+  installEnv(provider) {
+    const name = this.reinstalls(provider) ? provider.channels.native.versionEnv : null;
+    const latest = name ? this.versions.get(provider.id)?.latest : null;
+    return latest ? { [name]: latest } : null;
+  }
+
   /** Whether the tool is there to run: its command on PATH, and for a plugin a copy that `docker` runs. */
   installed(provider) {
     return Boolean(provider.plugin ? this._pluginPath(provider) : this.resolve(provider));
@@ -699,7 +714,7 @@ export class ProviderRegistry extends EventEmitter {
         guidance: `Homebrew moved ${provider.tool} from a formula to a cask, so brew upgrade no longer updates this copy. Run "brew uninstall ${channel.token}", then "brew install --cask ${channel.token}".`,
       };
     }
-    if (provider.plugin) return { file: null, args: [], command: channel.update.command, guidance: null };
+    if (provider.plugin || channel.update.reinstall) return { file: null, args: [], command: channel.update.command, guidance: null };
     const args = this.npmArgs(channel.update, this.versions.get(provider.id)?.latest ?? 'latest');
     const command = formatCommand(channel.update.file, args);
     if (channel.probe) {
@@ -828,8 +843,10 @@ export class ProviderRegistry extends EventEmitter {
       resumable: provider.resumeArgs.length > 0,
       launchFlags: provider.launchFlags.map(({ flag, risky }) => ({ flag, risky })),
       launchFlagsEquals: provider.launchFlagsEquals,
-      installable: provider.plugin ? Boolean(commandPath && !resolvedPath && !pluginError && !pluginPending && provider.install) : Boolean(provider.package && this.resolveNpm()),
-      installCommand: provider.plugin && provider.install ? provider.install : null,
+      installable: provider.plugin ? Boolean(commandPath && !resolvedPath && !pluginError && !pluginPending && provider.install)
+        : this.reinstalls(provider) || Boolean(provider.package && this.resolveNpm()),
+      installCommand: (provider.plugin || this.reinstalls(provider)) && provider.install ? provider.install : null,
+      plugin: provider.plugin,
       pluginError,
       pluginPending,
       installedVersion: installed,
@@ -853,6 +870,7 @@ export class ProviderRegistry extends EventEmitter {
       reporting: provider.reporting,
       reportingEnabled: this.reportingEnabled?.(provider) ?? null,
       reportingNote: this.reportingNote?.(provider) ?? null,
+      mcp: this.mcpState?.(provider) ?? null,
       accounts: provider.accounts.map((account) => ({ id: account.id, label: account.label })),
       accountsEditable: Boolean(provider.homeVar),
       shells: shells?.shells.map((shell) => ({ id: shell.id, label: shell.label, path: shell.path, multiplexer: Boolean(shell.multiplexer) })) ?? null,
@@ -935,7 +953,7 @@ export class ProviderRegistry extends EventEmitter {
     if (!update.command) {
       throw refusal(400, 'not_updatable', update.guidance || `Still checking how ${provider.tool} was installed. Try again in a moment.`);
     }
-    if (provider.plugin) return { spec: this._installCommandSpec(provider), channel: channel.channel };
+    if (provider.plugin || channel.update.reinstall) return { spec: this._installCommandSpec(provider), channel: channel.channel };
     if (!channel.update.package) return { spec: buildSpawnSpec(update.file, update.args, this.env, this.platform), channel: channel.channel };
     const args = this.npmArgs(channel.update, await this.resolveRelease(provider, update.file));
     return { spec: npmSpawnSpec(update.file, args, this.env, this.platform), channel: 'npm' };
@@ -963,6 +981,7 @@ export class ProviderRegistry extends EventEmitter {
       if (plugins.copies.some((c) => c.active)) throw refusal(409, 'already_installed', `${provider.tool} is already installed at ${this._pluginPath(provider)}.`);
       return this._installCommandSpec(provider);
     }
+    if (this.reinstalls(provider)) return this._installCommandSpec(provider);
     if (!provider.package) {
       const err = new Error(`${provider.tool} has no npm package configured; install it by hand: ${provider.install || provider.docs || 'see its documentation'}`);
       err.status = 400;

package/src/manager/report-shims.mjs

@@ -25,6 +25,14 @@ import path from 'node:path';
 
 export const SHIM_NAME = 'agent-guild-report';
 export const LOADER_NAME = 'agent-guild-report-loader.mjs';
+export const NATIVE_NAME = 'agent-guild-report-native';
+
+const exeName = (name, platform) => (platform === 'win32' ? `${name}.exe` : name);
+
+export function nativeReporter(root, { platform = process.platform, arch = process.arch } = {}) {
+  const file = path.join(root, 'bin', 'native', `${platform}-${arch}`, exeName(SHIM_NAME, platform));
+  return fs.existsSync(file) ? file : null;
+}
 
 /** Quote for double quotes in sh: backslash, double quote, dollar and backtick. */
 function shQuote(value) {
@@ -43,12 +51,13 @@ export function fileUrl(file, platform = process.platform) {
  * forward slashes in Windows paths, and a backslash would be an escape in
  * the sh shim, so the sh shim gets forward slashes on Windows.
  */
-export function shimContents({ execPath, script, platform = process.platform }) {
+export function shimContents({ execPath, script, platform = process.platform, native = null }) {
   const forSh = (p) => (platform === 'win32' ? p.replace(/\\/g, '/') : p);
   const files = {
     [SHIM_NAME]: [
       '#!/bin/sh',
       '[ "$1" = --hook ] && [ -z "$AGENT_GUILD_SESSION_ID" ] && exec cat >/dev/null',
+      ...(native ? [`r=${shQuote(forSh(native))}`, '[ "$1" = --hook ] && [ -x "$r" ] && "$r" "$@" && exit 0'] : []),
       `n=${shQuote(forSh(execPath))}`,
       '[ -x "$n" ] || n=node',
       `exec "$n" ${shQuote(forSh(script))} "$@"`,
@@ -56,30 +65,65 @@ export function shimContents({ execPath, script, platform = process.platform })
     ].join('\n'),
   };
   if (platform === 'win32') {
+    const exe = `%~dp0${exeName(NATIVE_NAME, platform)}`;
     files[LOADER_NAME] = `import ${JSON.stringify(fileUrl(script, platform))};\n`;
     files[`${SHIM_NAME}.cmd`] = [
       '@ECHO OFF',
       'IF "%~1"=="--hook" IF NOT DEFINED AGENT_GUILD_SESSION_ID EXIT /B 0',
+      ...(native ? [`IF "%~1"=="--hook" IF EXIST "${exe}" GOTO native`, ':node'] : []),
       'IF EXIST "%AGENT_GUILD_NODE%" GOTO manager',
       `node "%~dp0${LOADER_NAME}" %*`,
       'EXIT /B %ERRORLEVEL%',
       ':manager',
       `"%AGENT_GUILD_NODE%" "%~dp0${LOADER_NAME}" %*`,
+      ...(native ? ['EXIT /B %ERRORLEVEL%', ':native', `"${exe}" %*`, 'IF ERRORLEVEL 1 GOTO node'] : []),
       '',
     ].join('\r\n');
   }
   return files;
 }
 
+function installNative(source, file, platform) {
+  const tmp = `${file}.${process.pid}.tmp`;
+  fs.copyFileSync(source, tmp);
+  try { fs.chmodSync(tmp, 0o755); } catch {}
+  try {
+    fs.renameSync(tmp, file);
+  } catch (err) {
+    if (platform !== 'win32' || !fs.existsSync(file)) {
+      fs.rmSync(tmp, { force: true });
+      throw err;
+    }
+    const aside = `${file}.${process.pid}.old`;
+    fs.renameSync(file, aside);
+    fs.renameSync(tmp, file);
+    try { fs.unlinkSync(aside); } catch {}
+  }
+}
+
 /**
  * Write the shims into `dir` (created if needed), replacing stale ones
  * atomically so a hook that is starting meanwhile still runs a whole file.
  * Returns `dir`. Throws when the folder is not writable; the caller decides
  * whether that is fatal.
  */
-export function writeReportShims({ dir, execPath = process.execPath, script, platform = process.platform }) {
+export function writeReportShims({ dir, execPath = process.execPath, script, platform = process.platform, native = null, warn = console.warn }) {
   fs.mkdirSync(dir, { recursive: true });
-  const files = shimContents({ execPath, script, platform });
+  const copy = path.join(dir, exeName(NATIVE_NAME, platform));
+  const remove = (file) => { try { fs.rmSync(file, { force: true }); } catch {} };
+  for (const name of fs.readdirSync(dir)) {
+    if (name.startsWith(`${exeName(NATIVE_NAME, platform)}.`) && name.endsWith('.old')) remove(path.join(dir, name));
+  }
+  if (native) {
+    try {
+      installNative(native, copy, platform);
+    } catch (err) {
+      warn(`[manager] could not copy the native agent-guild-report to ${copy}: ${err.message}; ${fs.existsSync(copy) ? 'hooks keep the earlier copy' : 'hooks run the Node.js reporter'}`);
+    }
+  } else {
+    remove(copy);
+  }
+  const files = shimContents({ execPath, script, platform, native: native ? copy : null });
   for (const [name, contents] of Object.entries(files)) {
     const file = path.join(dir, name);
     const tmp = `${file}.${process.pid}.tmp`;

package/src/manager/server.mjs

@@ -25,6 +25,8 @@ const API = '/api/v1';
 const MAX_BODY = 64 * 1024;
 // A reply, and a Docker Agent stop that carries one, is a whole answer, which Claude Code does not clip.
 const REPLY_BODY_LIMIT = 1024 * 1024;
+const HOOK_BODY_LIMIT = 32 * 1024 * 1024;
+const MAX_HOOK_PARAM = 128;
 const MAX_WS_PAYLOAD = 1024 * 1024;
 // The API explorer (web/api.html) reads the doc itself.
 const API_DOC = path.join(path.dirname(require.resolve('../../package.json')), 'docs', 'api.md');
@@ -181,6 +183,8 @@ export function createManagerServer({
   nextManagerProblem = ptyRestartProblem,
   /** The Yard's art; without a data folder, only a checkout's. */
   yardArt = new YardArt({ webDir }),
+  mcpConnect = null,
+  heartbeatMs = 30000,
 }) {
   let listedProviders = null;
   const accounts = createAccountEditor({
@@ -306,14 +310,28 @@ export function createManagerServer({
     // Agent, model and tool-session reports may authenticate with the
     // per-session report token that the manager injects into each tool's
     // environment.
-    const reportMatch = route.match(/^\/sessions\/([a-f0-9]+)\/(agents|model|tool-session|context|reporting|shells|docker|reply)$/);
+    const reportMatch = route.match(/^\/sessions\/([a-f0-9]+)\/(agents|model|tool-session|context|reporting|shells|docker|reply|hook)$/);
     if (reportMatch && method === 'POST') {
       const [, id, kind] = reportMatch;
-      const body = await readJsonBody(req, kind === 'reply' || kind === 'docker' ? REPLY_BODY_LIMIT : MAX_BODY);
       const auth = {
         trusted: timingSafeEqualString(requestToken(req, url), token),
         reportToken: req.headers['x-agent-guild-report-token'],
       };
+      if (kind === 'hook') {
+        // Before the body, which may be large, is read.
+        manager.checkReportAuth(id, auth);
+        const param = (name) => {
+          const value = url.searchParams.get(name);
+          if (value !== null && (value.length > MAX_HOOK_PARAM || /\p{Cc}/u.test(value))) {
+            throw new HttpError(400, `${name} must be printable and at most ${MAX_HOOK_PARAM} characters`, 'bad_request');
+          }
+          return value;
+        };
+        const options = { event: param('event') || null, reporting: param('reporting') };
+        const errors = await manager.reportHook(id, await readJsonBody(req, HOOK_BODY_LIMIT), options, auth);
+        return sendJson(res, 200, errors.length ? { ok: true, errors } : { ok: true });
+      }
+      const body = await readJsonBody(req, kind === 'reply' || kind === 'docker' ? REPLY_BODY_LIMIT : MAX_BODY);
       if (kind === 'agents') return sendJson(res, 200, { agent: manager.reportAgent(id, body, auth) });
       if (kind === 'docker') {
         manager.reportDocker(id, body, auth);
@@ -501,6 +519,15 @@ export function createManagerServer({
       registry.emit('updated');
       return sendJson(res, 200, { provider: registry.describe(provider) });
     }
+    const mcpMatch = route.match(/^\/providers\/([a-z0-9][a-z0-9_-]{0,31})\/mcp$/);
+    if (mcpMatch && method === 'POST' && mcpConnect) {
+      const provider = registry.get(mcpMatch[1]);
+      if (!provider) throw new HttpError(404, `unknown provider "${mcpMatch[1]}"`, 'unknown_provider');
+      const body = await readJsonBody(req);
+      if (typeof body.enabled !== 'boolean') throw new HttpError(400, 'enabled must be true or false', 'bad_request');
+      const results = await mcpConnect.setEnabled(provider, body.enabled);
+      return sendJson(res, 200, { provider: registry.describe(provider), results });
+    }
     const multiplexerMatch = route.match(/^\/providers\/([a-z0-9][a-z0-9_-]{0,31})\/multiplexers\/([a-z0-9_-]+)\/(install|update|uninstall)$/);
     if (multiplexerMatch && method === 'POST') {
       const body = await readJsonBody(req);
@@ -802,7 +829,8 @@ export function createManagerServer({
       ws.isAlive = false;
       try { ws.ping(); } catch { /* closing */ }
     }
-  }, 30000);
+    if (mcpConnect && wss.clients.size) for (const provider of registry.providers) mcpConnect.refresh(provider).catch(() => {});
+  }, heartbeatMs);
   heartbeat.unref();
 
   return {

package/src/manager/session-manager.mjs

@@ -17,8 +17,11 @@ 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 { handleHookEvent } from '../report/hook-event.mjs';
 
 export const MAX_SESSIONS = 32;
+const TRUSTED = Object.freeze({ trusted: true });
+const unrefSleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms).unref());
 const TMUX_SESSION_GONE = [/^can't find session/m, /^no server running on /m, /^error connecting to .*\(No such file or directory\)$/m];
 
 // The hooks.json earlier versions copied into Codex CLI accounts; an untouched copy would run every hook twice.
@@ -502,11 +505,11 @@ export class SessionManager extends EventEmitter {
         const { spec, channel } = await this.registry.updateSpec(provider);
         guard();
         const name = `Update ${provider.tool} (${CHANNEL_LABELS[channel]})`;
-        return this._spawn({ provider, spawnSpec: spec, cwd: os.homedir(), name, task: 'install', installKind: 'update' });
+        return this._spawn({ provider, spawnSpec: spec, cwd: os.homedir(), name, task: 'install', installKind: 'update', extraEnv: this.registry.installEnv(provider) });
       }
       const spawnSpec = await this.registry.installSpec(provider);
       guard();
-      return this._spawn({ provider, spawnSpec, cwd: os.homedir(), name: `Install ${provider.tool}`, task: 'install', installKind: 'install' });
+      return this._spawn({ provider, spawnSpec, cwd: os.homedir(), name: `Install ${provider.tool}`, task: 'install', installKind: 'install', extraEnv: this.registry.installEnv(provider) });
     } finally {
       this.installing.delete(provider.id);
     }
@@ -865,6 +868,37 @@ export class SessionManager extends EventEmitter {
     session.docker.report(event);
   }
 
+  async reportHook(id, input, { event = null, reporting = null } = {}, auth) {
+    const session = this._reportingSession(id, auth);
+    const errors = [];
+    const apply = {
+      agents: (report) => this.reportAgent(id, report, TRUSTED),
+      model: (report) => this.reportModel(id, report, TRUSTED),
+      'tool-session': (report) => this.reportToolSession(id, report, TRUSTED),
+      context: (report) => this.reportContext(id, report, TRUSTED),
+      reply: (report) => this.reportReply(id, report, TRUSTED),
+      reporting: () => this.reportHello(id, TRUSTED),
+      shells: (report) => this.reportShell(id, report, TRUSTED),
+      docker: (report) => this.reportDocker(id, report, TRUSTED),
+    };
+    const send = async (report, kind) => {
+      try {
+        apply[kind](report);
+      } catch (err) {
+        errors.push({ status: err.status ?? 500, ...(err.code ? { code: err.code } : {}), message: err.message });
+      }
+    };
+    const { later } = await handleHookEvent(input, {
+      reporting: reporting ?? session.provider.reporting ?? '', event, since: Date.now() - 2000, send, sleep: unrefSleep,
+    });
+    later.catch((err) => console.warn(`[session ${id}] a hook report failed: ${err.message}`));
+    return errors;
+  }
+
+  checkReportAuth(id, auth) {
+    this._reportingSession(id, auth);
+  }
+
   _reportingSession(id, { reportToken, trusted = false } = {}) {
     const session = this.sessions.get(id);
     // Without the API token, an unknown session and a wrong token look the

package/src/manager/session.mjs

@@ -49,6 +49,7 @@ export function cleanName(name) {
   return typeof name === 'string' ? name.trim().slice(0, 80) : '';
 }
 const MAX_AGENTS = 64;
+export const SCROLLBACK_LINES = 1000;
 
 export function clampDimension(value, fallback, min, max) {
   const n = Math.floor(Number(value));
@@ -99,7 +100,7 @@ export class Session extends EventEmitter {
     this.cols = opts.cols;
     this.rows = opts.rows;
     this.reportToken = opts.reportToken;
-    this.scrollback = opts.scrollback ?? 5000;
+    this.scrollback = opts.scrollback ?? SCROLLBACK_LINES;
     this.activityIdleMs = opts.activityIdleMs ?? 2500;
     this.doneAgentLingerMs = opts.doneAgentLingerMs ?? 15000;
     this.killGraceMs = opts.killGraceMs ?? 4000;

package/src/report/hook-event.mjs

@@ -0,0 +1,40 @@
+import { hookRoute, hookToReports, dockerHookEvent, antigravityUserConversation } from './hooks.mjs';
+import * as transcripts from './transcripts.mjs';
+
+export function reportKind(report) {
+  if (report.compaction !== undefined) return 'context';
+  if (report.reply !== undefined) return 'reply';
+  if (report.shell !== undefined) return 'shells';
+  if (report.agentId !== undefined || report.finishForeground === true) return 'agents';
+  if (report.hello === true) return 'reporting';
+  if (report.toolSessionId !== undefined) return 'tool-session';
+  return 'model';
+}
+
+export async function handleHookEvent(input, { reporting = '', event = null, since = Date.now() - 2000, send, files = transcripts, sleep } = {}) {
+  const none = { later: Promise.resolve() };
+  if (!input || typeof input !== 'object') return none;
+  if (event && input.hook_event_name === undefined) input.hook_event_name = event;
+  const route = hookRoute(input, reporting);
+  if (!route) return none;
+  // Docker Agent's events go whole to the manager, which tells its sessions (tabs, sub-agents) apart.
+  if (route === 'docker') {
+    const docker = dockerHookEvent(input);
+    if (docker) await send(docker, 'docker');
+    return none;
+  }
+  // Antigravity CLI runs the hook in its sub-agents too, each a conversation of its own.
+  if (typeof input.conversationId === 'string' && !antigravityUserConversation(await files.firstRecord(input.transcriptPath))) return none;
+  const later = [];
+  for (const report of hookToReports(input)) {
+    if (report.transcript === undefined) await send(report, reportKind(report));
+    else {
+      later.push(files.claudeCompaction(report.transcript, since, sleep ? { sleep } : undefined)
+        .then((key) => (key ? send({ compaction: report.compaction, key }, 'context') : undefined)));
+    }
+  }
+  if (typeof input.conversationId === 'string' && input.hook_event_name === 'Stop') {
+    await send({ reply: await files.antigravityTranscriptReply(input.transcriptPath) }, 'reply');
+  }
+  return { later: Promise.all(later).then(() => {}) };
+}

package/src/report/transcripts.mjs

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import { antigravityReply, claudeCompactBoundary } from './hooks.mjs';
+
+const MAX_FIRST_LINE = 1024 * 1024;
+const COMPACTION_TAIL_BYTES = 1024 * 1024;
+const REPLY_WINDOW_BYTES = 256 * 1024;
+const MAX_REPLY_WINDOW_BYTES = 64 * 1024 * 1024;
+// Claude Code writes the compaction record a moment after its PostCompact hook starts.
+const COMPACTION_WAIT_MS = 3000;
+const COMPACTION_STEP_MS = 250;
+
+const parseJson = (raw) => { try { return JSON.parse(raw); } catch { return null; } };
+const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+async function openFile(file) {
+  if (typeof file !== 'string' || !file) return null;
+  try {
+    if (!(await fs.promises.stat(file)).isFile()) return null;
+    // Non-blocking, in case the path became a FIFO after the check: opening one would wait for a writer.
+    const handle = await fs.promises.open(file, fs.constants.O_RDONLY | (fs.constants.O_NONBLOCK ?? 0));
+    const stat = await handle.stat();
+    if (!stat.isFile()) {
+      await handle.close();
+      return null;
+    }
+    return { handle, size: stat.size };
+  } catch {
+    return null;
+  }
+}
+
+async function readRecords(handle, start, end) {
+  const buffer = Buffer.alloc(end - start);
+  const { bytesRead } = await handle.read(buffer, 0, buffer.length, start);
+  const lines = buffer.subarray(0, bytesRead).toString('utf8').split('\n');
+  // A window that starts mid-file starts mid-line.
+  if (start > 0) lines.shift();
+  return lines.map(parseJson);
+}
+
+/** The first JSON record of a JSONL file, or null. */
+export async function firstRecord(file) {
+  const opened = await openFile(file);
+  if (!opened) return null;
+  try {
+    const length = Math.min(opened.size, MAX_FIRST_LINE);
+    const buffer = Buffer.alloc(length);
+    const { bytesRead } = await opened.handle.read(buffer, 0, length, 0);
+    const end = buffer.subarray(0, bytesRead).indexOf(10);
+    return parseJson(buffer.subarray(0, end === -1 ? bytesRead : end).toString('utf8'));
+  } catch {
+    return null;
+  } finally {
+    await opened.handle.close().catch(() => {});
+  }
+}
+
+export async function tailRecords(file, bytes) {
+  const opened = await openFile(file);
+  if (!opened) return [];
+  try {
+    return await readRecords(opened.handle, Math.max(0, opened.size - bytes), opened.size);
+  } catch {
+    return [];
+  } finally {
+    await opened.handle.close().catch(() => {});
+  }
+}
+
+/** The last response of an Antigravity CLI turn, read back from the end of its transcript. */
+export async function antigravityTranscriptReply(file) {
+  const opened = await openFile(file);
+  if (!opened) return null;
+  try {
+    for (let bytes = REPLY_WINDOW_BYTES; ; bytes *= 4) {
+      const start = Math.max(0, opened.size - bytes);
+      const reply = antigravityReply(await readRecords(opened.handle, start, opened.size));
+      if (reply !== undefined || start === 0 || bytes >= MAX_REPLY_WINDOW_BYTES) return reply ?? null;
+    }
+  } catch {
+    return null;
+  } finally {
+    await opened.handle.close().catch(() => {});
+  }
+}
+
+export async function claudeCompaction(file, since, { sleep = wait } = {}) {
+  if (typeof file !== 'string' || !file) return null;
+  for (let waited = 0; waited <= COMPACTION_WAIT_MS; waited += COMPACTION_STEP_MS) {
+    if (waited) await sleep(COMPACTION_STEP_MS);
+    const key = claudeCompactBoundary(await tailRecords(file, COMPACTION_TAIL_BYTES), since);
+    if (key) return key;
+  }
+  return null;
+}

package/web/app.js

@@ -2265,6 +2265,53 @@ function renderReportingSetup(card, provider) {
   };
 }
 
+const MCP_STATES = { on: 'on', off: 'off', disabled: 'turned off in the tool', other: 'another server is named agent-guild', unknown: 'settings could not be read' };
+
+function mcpText(provider, mcp) {
+  if (mcp.state === 'checking') return 'Agent Guild MCP: checking';
+  if (mcp.state === 'on') return mcp.total > 1 ? `Agent Guild MCP on for all ${mcp.total} accounts` : 'Agent Guild MCP on';
+  if (mcp.state === 'partial') return `Agent Guild MCP on for ${mcp.on} of ${mcp.total} accounts`;
+  if (mcp.state === 'disabled') return `Agent Guild MCP turned off in ${provider.tool}`;
+  if (mcp.state === 'other') return 'Agent Guild MCP: another server is named agent-guild';
+  if (mcp.state === 'unknown') return 'Agent Guild MCP: settings could not be read';
+  return 'Agent Guild MCP off';
+}
+
+function renderMcpSetup(card, provider) {
+  const row = card.querySelector('.mcp-row');
+  const mcp = provider.mcp;
+  row.hidden = !provider.available || !mcp;
+  if (row.hidden) return;
+  const text = row.querySelector('.mcp-text');
+  text.textContent = mcpText(provider, mcp);
+  text.title = mcp.accounts.map((a) => `${a.label}: ${MCP_STATES[a.state] ?? a.state}${a.detail ? `. ${a.detail}` : ''}`).join('\n');
+  const states = new Set(mcp.accounts.map((a) => a.state));
+  const turnOn = row.querySelector('.mcp-on');
+  const turnOff = row.querySelector('.mcp-off');
+  turnOn.hidden = !states.has('off') && !states.has('disabled');
+  turnOff.hidden = !states.has('on') && !states.has('disabled');
+  turnOn.title = `Lets ${provider.tool} see your other Agent Guild sessions, read their answers and screens, and start or stop sessions when you approve. Typing into sessions stays off. Adds agent-guild to ${provider.tool}'s MCP servers for every account.`;
+  turnOff.title = `Removes Agent Guild's MCP server from ${provider.tool}'s settings. A server named agent-guild that runs something else is left as it is.`;
+  const change = async (enabled) => {
+    turnOn.disabled = turnOff.disabled = true;
+    try {
+      const { results } = await api('POST', `/providers/${provider.id}/mcp`, { enabled });
+      const problems = results.filter((r) => r.outcome === 'failed' || r.outcome === 'skipped');
+      const done = results.length - problems.length;
+      const lead = !problems.length ? `Agent Guild MCP is ${enabled ? `on for ${provider.tool}. New sessions can use it` : `off for ${provider.tool}`}.`
+        : `Agent Guild MCP is ${enabled ? 'on' : 'off'} for ${done} of ${results.length} ${provider.tool} accounts.`;
+      toast([lead, ...problems.map((r) => `${r.label}: ${r.detail ?? MCP_STATES[r.state] ?? r.state}.`)].join(' '), problems.length ? 12000 : undefined);
+    } catch (err) {
+      if (err instanceof AuthError) return showAuth(err.message);
+      toast(err.message, 10000);
+    } finally {
+      turnOn.disabled = turnOff.disabled = false;
+    }
+  };
+  turnOn.onclick = () => change(true);
+  turnOff.onclick = () => change(false);
+}
+
 let dealt = false;
 
 // Both layouts mount these same controls with these same command handlers.
@@ -2311,7 +2358,8 @@ function buildProvider(provider) {
     if (provider.available && provider.instructionsSource && !instructionCounts.has(instructionKey(provider))) refreshInstructionCounts();
     const install = node.querySelector('.install');
     install.hidden = provider.available || !provider.installable;
-    install.title = provider.installCommand ? `Downloads the latest ${provider.tool} release into Docker's plugin folder, in a session.` : `Install ${provider.tool} using npm.${provider.npmNote ? ` ${provider.npmNote}` : ''}`;
+    install.title = provider.plugin ? `Downloads the latest ${provider.tool} release into Docker's plugin folder, in a session.`
+      : provider.installCommand ? `Run "${provider.installCommand}" in a session` : `Install ${provider.tool} using npm.${provider.npmNote ? ` ${provider.npmNote}` : ''}`;
     install.addEventListener('click', () => installProvider(provider, node));
     const update = node.querySelector('.update');
     update.hidden = !(provider.available && provider.updateCommand && (provider.updateAvailable || checkFailed));
@@ -2336,6 +2384,7 @@ function buildProvider(provider) {
     renderMultiplexers(node, provider);
     renderUsage(node, provider);
     renderReportingSetup(node, provider);
+    renderMcpSetup(node, provider);
     renderModelStats(node, provider);
     renderProviderPending(node, provider);
     paintManagerActions(node);
@@ -3830,7 +3879,7 @@ function installNote(provider) {
   }
   if (last.kind === 'uninstall') return last.outcome === 'remaining' ? 'Uninstalled copy is still present' : '';
   if (last.verification === 'failed') return `Installation completed, but ${provider.tool} verification failed`;
-  if (last.outcome === 'missing') return provider.installCommand ? 'Installed, but docker does not list it' : 'Installed, but not found on PATH';
+  if (last.outcome === 'missing') return provider.plugin ? 'Installed, but docker does not list it' : 'Installed, but not found on PATH';
   if (last.outcome === 'unchanged') return 'No version change after update';
   return '';
 }
@@ -6702,7 +6751,7 @@ class TerminalView {
       cursorBlink: true,
       fontFamily: 'ui-monospace, "Cascadia Code", "SF Mono", Menlo, Consolas, monospace',
       fontSize: terminalFontSize,
-      scrollback: 5000,
+      scrollback: 1000,
       macOptionIsMeta: true,
       // Option-drag selects text even while a program reads the mouse, as Shift-drag does elsewhere.
       macOptionClickForcesSelection: true,

package/web/index.html

@@ -137,7 +137,7 @@
           <div class="yard-overlay">
             <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 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><button id="yard-photo" type="button" class="btn" aria-haspopup="dialog" aria-label="Save a picture of the Yard" title="Save a picture of the Yard" disabled hidden><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M4 8.5A1.5 1.5 0 0 1 5.5 7h2.3l1.4-2h5.6l1.4 2h2.3A1.5 1.5 0 0 1 20 8.5v9a1.5 1.5 0 0 1-1.5 1.5h-13A1.5 1.5 0 0 1 4 17.5z"/><circle cx="12" cy="12.75" r="3.25"/></svg></button></div>
+            <div class="yard-camera" role="group" aria-label="Yard controls"><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><button id="yard-photo" type="button" class="btn" aria-haspopup="dialog" aria-label="Save a picture of the Yard" title="Save a picture of the Yard" disabled hidden><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" focusable="false"><path d="M4 8.5A1.5 1.5 0 0 1 5.5 7h2.3l1.4-2h5.6l1.4 2h2.3A1.5 1.5 0 0 1 20 8.5v9a1.5 1.5 0 0 1-1.5 1.5h-13A1.5 1.5 0 0 1 4 17.5z"/><circle cx="12" cy="12.75" r="3.25"/></svg></button><button id="yard-fireworks" type="button" class="btn" aria-label="Fireworks in this Yard only" title="Fireworks in this Yard only" disabled><svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="1.7" stroke-linecap="round" aria-hidden="true" focusable="false"><path d="M12 3v3m0 9v6M3 10h3m12 0h3M5.6 3.6l2.2 2.2m8.4 8.4 2.2 2.2M18.4 3.6l-2.2 2.2m-8.4 8.4-2.2 2.2"/><circle cx="12" cy="10" r="1"/></svg></button></div>
             <p id="yard-help"><span class="yard-help-pointer">Drag to explore · Scroll to zoom · Select to inspect · Double-click a session to open</span><span class="yard-help-touch">Drag to explore · Pinch to zoom · Tap to inspect · Open from the Inspector</span></p>
           </div>
         </div>
@@ -817,6 +817,12 @@
         <span class="reporting-text"></span>
         <button class="btn reporting-toggle" type="button"></button>
       </div>
+      <div class="reporting-row mcp-row" hidden>
+        <span class="mcp-text"></span>
+        <a class="console-link mcp-docs" href="https://github.com/oddessentials/agent-guild/blob/main/docs/mcp.md" target="_blank" rel="noopener noreferrer" title="What Agent Guild's MCP server lets a coding agent do">About</a>
+        <button class="btn mcp-on" type="button">Turn on</button>
+        <button class="btn mcp-off" type="button">Turn off</button>
+      </div>
       <div class="provider-links">
         <a class="console-link usage-link" target="_blank" rel="noopener noreferrer">Usage</a>
         <a class="console-link billing-link" target="_blank" rel="noopener noreferrer">Billing</a>

package/web/styles.css

@@ -308,6 +308,8 @@ main { max-width: calc(1200px + var(--dock-space, 0px)); margin: 0 auto; padding
 }
 .reporting-row { display: flex; align-items: center; gap: 10px; font-size: 0.78rem; color: var(--muted); }
 .reporting-row .btn { padding: 2px 10px; font-size: 0.75rem; white-space: nowrap; }
+.mcp-row { flex-wrap: wrap; row-gap: 4px; }
+.mcp-row .mcp-text { flex-basis: 100%; }
 .console-link { color: var(--accent); text-decoration: none; }
 .console-link:hover { text-decoration: underline; }
 .console-link:focus-visible { outline: 2px solid var(--focus); outline-offset: 2px; border-radius: 3px; }