glimmervoid 0.45.0 → 0.45.1-next.45

package/dist/bin/glimmervoid.js

@@ -2,12 +2,12 @@
 import { o as nodePtyRebuildHint, r as firstLine, t as probeNodePty } from "../chunks/node-pty-preflight-C8QIlrtU.js";
 import { i as errorText } from "../chunks/text-DoirglWV.js";
 import { o as packageRoot } from "../chunks/runtime-paths-ghcH9CeW.js";
-import { t as AGENT_API_VERBS } from "../chunks/session-CUc6d7aS.js";
+import { n as glimmervoidHomeDir, t as decideConfigPath } from "../chunks/config-path-core-DUWk0Lui.js";
+import { t as AGENT_API_VERBS } from "../chunks/session-BwlLY_mv.js";
 import { i as execSync } from "../chunks/child-process-safe-D4hyVIXj.js";
-import { r as agentCommandHelpLines } from "../chunks/agent-api-core-D49OzKho.js";
+import { r as agentCommandHelpLines } from "../chunks/agent-api-core-ClU9-5K3.js";
 import { t as renderTable } from "../chunks/ascii-figure-core-pDAwtlKO.js";
-import { n as glimmervoidHomeDir, t as decideConfigPath } from "../chunks/config-path-core-DFt-TemS.js";
-import { i as parseCommandLine, r as gitDoctorRows, t as probeGitVersion } from "../chunks/git-version-C3lznLS_.js";
+import { i as parseCommandLine, r as gitDoctorRows, t as probeGitVersion } from "../chunks/git-version-BpdkKH2j.js";
 import { i as guardrailsDoctorRows, r as probeGuardrailsDependencies } from "../chunks/guardrails-deps-BjPzk1rE.js";
 import { i as pnpmGlobalBinDir, n as npmGlobalBinDir, r as onPath, t as formatPathNotice } from "../chunks/path-doctor-C23VAqeu.js";
 import fs from "node:fs";
@@ -65,15 +65,15 @@ var OWN_SUBCOMMAND_RUNNERS = [
 		return 0;
 	}],
 	["pair", async (subcommandArgs) => {
-		const { runPairCli } = await import("../chunks/pair-cli-BPyh48--.js");
+		const { runPairCli } = await import("../chunks/pair-cli-Cph4TZ2R.js");
 		return runPairCli(subcommandArgs);
 	}],
 	["agent", async (subcommandArgs) => {
-		const { runAgentSetupCli } = await import("../chunks/agent-setup-cli-7hG401Io.js");
+		const { runAgentSetupCli } = await import("../chunks/agent-setup-cli-BA_1AdhQ.js");
 		return runAgentSetupCli(subcommandArgs);
 	}],
 	["settings", async (subcommandArgs) => {
-		const { runSettingsCli } = await import("../chunks/settings-cli-DzIasX94.js");
+		const { runSettingsCli } = await import("../chunks/settings-cli-Bete5oVk.js");
 		return runSettingsCli(subcommandArgs);
 	}],
 	["visions", async (subcommandArgs) => {
@@ -81,13 +81,13 @@ var OWN_SUBCOMMAND_RUNNERS = [
 		return runVisionsCli(subcommandArgs);
 	}],
 	["ssh-sign", async (subcommandArgs) => {
-		const { runSshSignCli } = await import("../chunks/ssh-sign-cli-C_QYhDvI.js");
+		const { runSshSignCli } = await import("../chunks/ssh-sign-cli-DXhuqzuy.js");
 		return runSshSignCli(subcommandArgs);
 	}]
 ];
 var ownSubcommandNames = new Set(OWN_SUBCOMMAND_RUNNERS.map(([name]) => name));
 var SUBCOMMAND_RUNNERS = new Map([...OWN_SUBCOMMAND_RUNNERS, ...AGENT_API_VERBS.filter((verb) => !ownSubcommandNames.has(verb)).map((verb) => [verb, async (subcommandArgs, subcommandName) => {
-	const { runAgentApiCli } = await import("../chunks/agent-api-cli-DdrR2vnB.js");
+	const { runAgentApiCli } = await import("../chunks/agent-api-cli-B0l8uLos.js");
 	return runAgentApiCli([subcommandName, ...subcommandArgs]);
 }])]);
 var AGENT_INSTALL_COMMAND_BY_ID = {
@@ -101,7 +101,7 @@ function missingAgentText(agentId) {
 }
 async function printSessionLimits() {
 	if (!process.env["GLIMMERVOID_AGENT_URL"]) return;
-	const { sessionLimitsHelpLines } = await import("../chunks/agent-api-cli-DdrR2vnB.js");
+	const { sessionLimitsHelpLines } = await import("../chunks/agent-api-cli-B0l8uLos.js");
 	const limitsLines = await sessionLimitsHelpLines();
 	console.log(`\n${limitsLines.join("\n")}`);
 }
@@ -158,7 +158,7 @@ async function readDeclaredCustomAgents() {
 		declared: [],
 		error: null
 	};
-	const { loadConfigFile } = await import("../chunks/config-store-DlaaBY9p.js");
+	const { loadConfigFile } = await import("../chunks/config-store-5xpRLHFo.js");
 	try {
 		const loaded = loadConfigFile(decided.path, { exitOnError: false });
 		if (!loaded.config) return {
@@ -234,7 +234,7 @@ async function runDoctor() {
 	}
 	switchSection("Agents");
 	try {
-		const { listAgentIds, describeAgentResolvability, setCustomAgents } = await import("../chunks/adapters-BGuI5U_-.js");
+		const { listAgentIds, describeAgentResolvability, setCustomAgents } = await import("../chunks/adapters-CPaysZkO.js");
 		const declaredCustomAgents = await readDeclaredCustomAgents();
 		if (declaredCustomAgents.error) line("config", declaredCustomAgents.error);
 		setCustomAgents(declaredCustomAgents.declared);
@@ -242,7 +242,7 @@ async function runDoctor() {
 			const { label, path: resolvedPath } = describeAgentResolvability(id);
 			line(`${id} (${label})`, resolvedPath ?? missingAgentText(id));
 		}
-		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-7hG401Io.js");
+		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-BA_1AdhQ.js");
 		const grokSetup = inspectGrokAgentSetup();
 		line("grok hook setup", `${grokSetup.classification}: ${grokSetup.filePath}`);
 	} catch (err) {
@@ -250,7 +250,7 @@ async function runDoctor() {
 	}
 	switchSection("rtk");
 	try {
-		const { getRtkPath } = await import("../chunks/rtk-resolver-Dr4iJsiS.js");
+		const { getRtkPath } = await import("../chunks/rtk-resolver-DgnNb1or.js");
 		line("rtk", getRtkPath() || "not installed (Glimmervoid installs it when the rtk setting is on)");
 	} catch (err) {
 		line("rtk", `probe failed: ${firstLine(errorText(err))}`);
@@ -259,7 +259,7 @@ async function runDoctor() {
 	try {
 		const { resolvePackageBin } = await import("../chunks/runtime-paths-Cc0_ZR6V.js");
 		const { execFileSync } = await import("../chunks/child-process-safe-CjVtRjDD.js");
-		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-7hG401Io.js");
+		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-BA_1AdhQ.js");
 		const binPath = resolvePackageBin("cc-safety-net", "cc-safety-net");
 		line("Sane YOLO", binPath || "not installed");
 		if (binPath) line("cc-safety-net version", execFileSync(process.execPath, [binPath, "--version"], {

package/dist/chunks/{adapters-D99c4zCx.js → adapters-BE9BKVW0.js}

@@ -1,14 +1,14 @@
 import { s as relayPath } from "./runtime-paths-ghcH9CeW.js";
-import { Vt as shortSha$1, zt as FULL_SHA_RE } from "./session-CUc6d7aS.js";
+import { Bt as FULL_SHA_RE, Ht as shortSha$1 } from "./session-BwlLY_mv.js";
 import { n as execFileAsync, r as execFileSync } from "./child-process-safe-D4hyVIXj.js";
-import { S as InstallFlavor } from "./config-BLeRKmn9.js";
-import { o as supervisionLine } from "./session-routes--hrsvv7a.js";
+import { b as InstallFlavor, mt as UpdateChannel } from "./config-BqJTnPae.js";
+import { o as supervisionLine } from "./session-routes-CviNvxcz.js";
 import { c as textOr, s as rawTextOr } from "./coerce-NSst8oRP.js";
 import { n as resolveAgentCommand, t as buildAgentSpawnCommand } from "./spawn-command-Cc40FiZI.js";
 import { r as nextBackoffMs } from "./backoff-DjVpfHk7.js";
-import { i as isSpinnerChar, n as classifyAgentTitle, r as isBrailleChar, s as buildAgentEnv, t as grok } from "./grok-Di4aQGre.js";
+import { i as isSpinnerChar, n as classifyAgentTitle, r as isBrailleChar, s as buildAgentEnv, t as grok } from "./grok-7jK8ZNtf.js";
 import { t as buildHookCommand } from "./hook-command-core-qTNK-xMF.js";
-import "./contracts-CucdticH.js";
+import { n as isExperimentalBuild, t as compareReleaseVersions } from "./build-channel-qgKwNssc.js";
 import { n as mergeCodexPreToolUse, t as HOOK_TOOLS } from "./hook-tools-Dl7-r2Eb.js";
 import fs from "node:fs";
 import path from "node:path";
@@ -411,8 +411,7 @@ var NODE_PTY_INSTALL_SCRIPT_FLAG = "--allow-scripts=node-pty";
 var NPX_CACHE_DIRECTORY_NAME = "_npx";
 var CLONE_COMMAND = "git pull --ff-only && npm ci && npm run build";
 var INSTALL_FLAVORS = new Set(InstallFlavor.options);
-var TAG_VERSION_RE = /^v(\d+\.\d+\.\d+)$/;
-var UPDATE_CHANNELS = /* @__PURE__ */ new Set(["release", "main"]);
+var TAG_VERSION_RE = /^v(\d+\.\d+\.\d+(?:-next\.\d+)?)$/;
 var DEPRECATION_MESSAGE_MAX_CHARS = 500;
 function normalizeSha(value) {
 	if (typeof value !== "string") return null;
@@ -486,7 +485,7 @@ function buildUpdateCommand(flavor, latestVersion, platform) {
 }
 function buildReleaseUrl(version) {
 	const releaseVersion = textOr(version, null);
-	if (!releaseVersion) return null;
+	if (!releaseVersion || isExperimentalBuild(releaseVersion)) return null;
 	return `https://github.com/${REPO_SLUG}/releases/tag/v${releaseVersion}`;
 }
 function parseVersionTriple(version) {
@@ -522,6 +521,15 @@ function parseRegistryLatest(doc) {
 		sha: normalizeSha(registryDocument.gitHead)
 	};
 }
+function pickNewestPublished(...publishedVersions) {
+	let newest = null;
+	for (const published of publishedVersions) {
+		if (!published) continue;
+		if (newest && compareReleaseVersions(published.version, newest.version) <= 0) continue;
+		newest = published;
+	}
+	return newest;
+}
 function parseRegistryDeprecation(doc) {
 	if (!doc || typeof doc !== "object") return null;
 	const deprecated = doc.deprecated;
@@ -535,30 +543,23 @@ function normalizeFlavor(flavor) {
 	return "unknown";
 }
 function normalizeUpdateChannel(channel) {
-	if (typeof channel === "string" && UPDATE_CHANNELS.has(channel)) return channel;
-	return "release";
-}
-function normalizeBehindCount(value) {
-	if (!Number.isInteger(value)) return null;
-	const count = Number(value);
-	if (count < 0) return null;
-	return count;
+	const parsed = UpdateChannel.safeParse(channel);
+	return parsed.success ? parsed.data : "release";
 }
 function decideUpdateReason({ isReleaseAlreadyCheckedOut, reason }) {
 	if (isReleaseAlreadyCheckedOut) return "release-already-checked-out";
 	return textOr(reason, null);
 }
-function decideUpdateStatus({ installedSha, latestSha: remoteSha, currentVersion, latestVersion, flavor, platform, channel, behindCount, reason, isLatestReleaseAncestorOfHead, deprecation } = {}) {
+function decideUpdateStatus({ installedSha, latestSha: remoteSha, currentVersion, latestVersion, flavor, platform, channel, reason, isLatestReleaseAncestorOfHead, deprecation } = {}) {
 	const currentSha = normalizeSha(installedSha);
 	const latestSha = normalizeSha(remoteSha);
 	const current = textOr(currentVersion, null);
 	const latest = textOr(latestVersion, null);
 	const normalizedFlavor = normalizeFlavor(flavor);
-	const normalizedChannel = normalizeUpdateChannel(channel);
-	const normalizedBehindCount = normalizeBehindCount(behindCount);
-	const isReleaseAlreadyCheckedOut = normalizedChannel === "release" && normalizedFlavor === "clone" && isLatestReleaseAncestorOfHead === true && compareSemver(latest, current) > 0;
+	const isTargetInCheckout = normalizedFlavor === "clone" && isLatestReleaseAncestorOfHead === true && compareReleaseVersions(latest, current) > 0;
+	const isReleaseAlreadyCheckedOut = isTargetInCheckout && !isExperimentalBuild(latest);
 	return {
-		updateAvailable: normalizedChannel === "main" ? normalizedBehindCount !== null && normalizedBehindCount > 0 && currentSha !== latestSha : !isReleaseAlreadyCheckedOut && compareSemver(latest, current) > 0,
+		updateAvailable: !isTargetInCheckout && compareReleaseVersions(latest, current) > 0,
 		current,
 		latest,
 		currentSha,
@@ -566,8 +567,7 @@ function decideUpdateStatus({ installedSha, latestSha: remoteSha, currentVersion
 		releaseUrl: buildReleaseUrl(latest),
 		command: buildUpdateCommand(flavor, latest, platform),
 		flavor: normalizedFlavor,
-		channel: normalizedChannel,
-		behindCount: normalizedBehindCount,
+		channel: normalizeUpdateChannel(channel),
 		reason: decideUpdateReason({
 			isReleaseAlreadyCheckedOut,
 			reason
@@ -1102,4 +1102,4 @@ function resetCommandCache() {
 	resolvedCommands.clear();
 }
 //#endregion
-export { dedupeCodexFiles as A, shouldPersistWarehouse as B, shortSha as C, codexSessionIdFromPath as D, codexRootCandidates as E, passOutcome as F, claudeCode as H, projectDirCandidates as I, resolveProjectsDirs as L, grokHomes as M, grokRootCandidates as N, continuationDelayMs as O, isUsageFile as P, scopedClaudeRoots as R, parseResolvedSha as S, codexHomes as T, splitLines as V, isCheckFresh as _, describeAgentResolvability as a, parseRegistryDeprecation as b, isKnownAgentId as c, resolveAdapter as d, setCustomAgents as f, decideUpdateStatus as g, decideInstallFlavor as h, customAgentFingerprint as i, expandTilde as j, decideFileRead as k, listAgentIds as l, readHostCodexVersion as m, cachedAgentResolvability as n, getAdapter as o, codex as p, commandFor as r, hookProfileOf as s, DEFAULT_AGENT_ID as t, resetCommandCache as u, normalizeSha as v, codexFallbackRoots as w, parseRegistryLatest as x, normalizeUpdateChannel as y, shouldEvaluateDespiteIoFailures as z };
+export { decideFileRead as A, shouldEvaluateDespiteIoFailures as B, pickNewestPublished as C, codexRootCandidates as D, codexHomes as E, isUsageFile as F, splitLines as H, passOutcome as I, projectDirCandidates as L, expandTilde as M, grokHomes as N, codexSessionIdFromPath as O, grokRootCandidates as P, resolveProjectsDirs as R, parseResolvedSha as S, codexFallbackRoots as T, claudeCode as U, shouldPersistWarehouse as V, isCheckFresh as _, describeAgentResolvability as a, parseRegistryDeprecation as b, isKnownAgentId as c, resolveAdapter as d, setCustomAgents as f, decideUpdateStatus as g, decideInstallFlavor as h, customAgentFingerprint as i, dedupeCodexFiles as j, continuationDelayMs as k, listAgentIds as l, readHostCodexVersion as m, cachedAgentResolvability as n, getAdapter as o, codex as p, commandFor as r, hookProfileOf as s, DEFAULT_AGENT_ID as t, resetCommandCache as u, normalizeSha as v, shortSha as w, parseRegistryLatest as x, normalizeUpdateChannel as y, scopedClaudeRoots as z };

package/dist/chunks/{adapters-BGuI5U_-.js → adapters-CPaysZkO.js}

@@ -1 +1 @@
-export { a as describeAgentResolvability, l as listAgentIds, f as setCustomAgents } from "./adapters-D99c4zCx.js";
+export { a as describeAgentResolvability, l as listAgentIds, f as setCustomAgents } from "./adapters-BE9BKVW0.js";

package/dist/chunks/{agent-api-cli-DdrR2vnB.js → agent-api-cli-B0l8uLos.js}

@@ -1 +1 @@
-export { t as askAgentApi, r as runAgentApiCli, i as sessionLimitsHelpLines } from "./agent-api-cli-DIGH1v3_.js";
+export { t as askAgentApi, r as runAgentApiCli, i as sessionLimitsHelpLines } from "./agent-api-cli-Bq9J0_D5.js";

package/dist/chunks/{agent-api-cli-DIGH1v3_.js → agent-api-cli-Bq9J0_D5.js}

@@ -1,12 +1,15 @@
 import { t as errorCode } from "./text-DoirglWV.js";
-import { c as AgentLimitsReply, n as AGENT_URL_ENV } from "./session-CUc6d7aS.js";
-import { i as formatSessionLimits } from "./session-routes--hrsvv7a.js";
-import { f as isAgentApiVerb, t as AGENT_COMMAND_HELP } from "./agent-api-core-D49OzKho.js";
+import { c as AgentLimitsReply, n as AGENT_URL_ENV } from "./session-BwlLY_mv.js";
+import { i as formatSessionLimits } from "./session-routes-CviNvxcz.js";
+import { f as isAgentApiVerb, t as AGENT_COMMAND_HELP } from "./agent-api-core-ClU9-5K3.js";
 import { i as resolveHookTarget } from "./hook-relay-core-DA_bz2KA.js";
 import { n as decideGuardrailsProxy } from "./guardrails-proxy-core-BI3rdY-m.js";
 import { t as parseJsonOrNull } from "./json-core-dfa_7Fak.js";
+import { r as describeOverCap } from "./shown-files-core-soMzCQ1D.js";
+import fs from "node:fs";
 import path from "node:path";
 import http from "node:http";
+import { pipeline } from "node:stream";
 //#region server/agent-api-cli.ts
 var AGENT_PATH_PREFIX = "/agent/";
 var HELP_LIMITS_TIMEOUT_MS = 2e3;
@@ -109,20 +112,14 @@ async function postDirectly({ endpoint, headers, bodyText, deadline }) {
 		text: await response.text()
 	};
 }
-function postThroughGuardrailsProxy(guardrailsProxy, { endpoint, headers, bodyText, deadline }) {
-	const proxyHeaders = guardrailsProxy.authorization ? { "proxy-authorization": guardrailsProxy.authorization } : {};
+function requestOverHttp(target, deadline, sendBody) {
 	return new Promise((resolve, reject) => {
 		const request = http.request({
-			host: guardrailsProxy.hostname,
-			port: guardrailsProxy.port,
+			host: target.hostname,
+			port: target.port,
 			method: "POST",
-			path: endpoint.href,
-			headers: {
-				...headers,
-				...proxyHeaders,
-				host: endpoint.host,
-				"content-length": String(Buffer.byteLength(bodyText))
-			},
+			path: target.path,
+			headers: target.headers,
 			...deadline ? { signal: deadline } : {}
 		}, (response) => {
 			const chunks = [];
@@ -139,10 +136,30 @@ function postThroughGuardrailsProxy(guardrailsProxy, { endpoint, headers, bodyTe
 			});
 		});
 		request.on("error", reject);
-		request.end(bodyText);
+		sendBody(request);
 	});
 }
+function guardrailsProxyTarget(guardrailsProxy, endpoint, headers) {
+	const proxyHeaders = guardrailsProxy.authorization ? { "proxy-authorization": guardrailsProxy.authorization } : {};
+	return {
+		hostname: guardrailsProxy.hostname,
+		port: String(guardrailsProxy.port),
+		path: endpoint.href,
+		headers: {
+			...headers,
+			...proxyHeaders,
+			host: endpoint.host
+		}
+	};
+}
+function postThroughGuardrailsProxy(guardrailsProxy, { endpoint, headers, bodyText, deadline }) {
+	return requestOverHttp(guardrailsProxyTarget(guardrailsProxy, endpoint, {
+		...headers,
+		"content-length": String(Buffer.byteLength(bodyText))
+	}), deadline, (request) => request.end(bodyText));
+}
 function wasConnectionRefused(error) {
+	if (errorCode(error) === "ECONNREFUSED") return true;
 	return errorCode(error?.cause) === "ECONNREFUSED";
 }
 async function postToAgentIngress({ endpoint, token, body, deadline = null }) {
@@ -180,12 +197,128 @@ async function sessionLimitsHelpLines({ timeoutMs = HELP_LIMITS_TIMEOUT_MS } = {
 		return [HELP_LIMITS_UNKNOWN_LINE];
 	}
 }
+function parseShowArguments(words) {
+	const filePaths = [];
+	let caption = null;
+	for (let index = 0; index < words.length; index += 1) {
+		const word = words[index];
+		if (word === "--caption") {
+			caption = words[index + 1] ?? "";
+			index += 1;
+			continue;
+		}
+		if (word.startsWith("--caption=")) {
+			caption = word.slice(10);
+			continue;
+		}
+		filePaths.push(word);
+	}
+	if (filePaths.length === 0) return null;
+	return {
+		filePaths,
+		caption: caption?.trim().slice(0, 500) || null
+	};
+}
+async function statFileToShow(filePath) {
+	const absolutePath = path.resolve(filePath);
+	const stats = await fs.promises.stat(absolutePath).catch(() => null);
+	if (!stats?.isFile()) return `${filePath} is not a file this session can read`;
+	if (stats.size > 209715200) return describeOverCap(filePath, stats.size);
+	return {
+		filePath: absolutePath,
+		name: path.basename(absolutePath),
+		sizeBytes: stats.size
+	};
+}
+function showHeaders(token, file, caption) {
+	const headers = {
+		authorization: `Bearer ${token}`,
+		"content-type": "application/octet-stream",
+		"content-length": String(file.sizeBytes),
+		"x-glimmervoid-show-name": encodeURIComponent(file.name)
+	};
+	if (caption) headers["x-glimmervoid-show-caption"] = encodeURIComponent(caption);
+	return headers;
+}
+function streamFileBody(filePath) {
+	return (request) => {
+		pipeline(fs.createReadStream(filePath), request, (error) => {
+			if (error) request.destroy(error);
+		});
+	};
+}
+async function postFileToShow(endpoint, token, file, caption) {
+	const headers = showHeaders(token, file, caption);
+	const directTarget = {
+		hostname: endpoint.hostname,
+		port: endpoint.port,
+		path: `${endpoint.pathname}${endpoint.search}`,
+		headers
+	};
+	try {
+		return await requestOverHttp(directTarget, null, streamFileBody(file.filePath));
+	} catch (error) {
+		if (!wasConnectionRefused(error)) throw error;
+		const guardrailsProxy = decideGuardrailsProxy(process.env);
+		if (!guardrailsProxy) throw error;
+		return requestOverHttp(guardrailsProxyTarget(guardrailsProxy, endpoint, headers), null, streamFileBody(file.filePath));
+	}
+}
+function replyError(replyText) {
+	const reply = parseJsonOrNull(replyText);
+	const error = typeof reply === "object" && reply !== null ? reply.error : null;
+	return typeof error === "string" ? error : `Glimmervoid answered ${replyText || "nothing"}`;
+}
+async function runShowCommand(words) {
+	const request = parseShowArguments(words);
+	if (!request) {
+		console.error(AGENT_COMMAND_HELP.show.missingArgumentHint ?? "glimmervoid show: this command needs a file path");
+		return 1;
+	}
+	const target = sessionEndpoint("show");
+	if (!target.ok) {
+		console.error(target.error);
+		return 1;
+	}
+	const filesToShow = [];
+	for (const filePath of request.filePaths) {
+		const checked = await statFileToShow(filePath);
+		if (typeof checked === "string") {
+			console.log(JSON.stringify({
+				ok: false,
+				error: checked,
+				shown: []
+			}));
+			return 1;
+		}
+		filesToShow.push(checked);
+	}
+	const shown = [];
+	for (const file of filesToShow) {
+		const reply = await postFileToShow(target.endpoint, target.token, file, request.caption);
+		if (!reply.hasSuccessStatus || !bodySaysOk(reply.text)) {
+			console.log(JSON.stringify({
+				ok: false,
+				error: replyError(reply.text),
+				shown
+			}));
+			return 1;
+		}
+		shown.push(parseJsonOrNull(reply.text)?.shown ?? { name: file.name });
+	}
+	console.log(JSON.stringify({
+		ok: true,
+		shown
+	}));
+	return 0;
+}
 async function runAgentApiCli(args) {
 	const verb = args[0];
 	if (!verb || !isAgentApiVerb(verb)) {
 		console.error(`glimmervoid: ${verb || "that"} is not an agent command`);
 		return 1;
 	}
+	if (verb === "show") return runShowCommand(args.slice(1));
 	const body = BODY_BUILDERS[verb](args.slice(1));
 	if (!body) {
 		console.error(AGENT_COMMAND_HELP[verb].missingArgumentHint ?? `glimmervoid ${verb}: this command needs an argument`);

package/dist/chunks/{agent-api-core-D49OzKho.js → agent-api-core-ClU9-5K3.js}

@@ -1,6 +1,6 @@
-import { R as TASK_TITLE_CONTROL_CHARACTERS, T as RefinedTaskTitle, a as AgentAttentionRequest, d as AgentSendRequest, i as AgentAnswerRequest, l as AgentPullRequestRequest, m as AgentSpawnRequest, o as AgentCloseRequest, p as AgentSettingsRequest, s as AgentEditRequest, t as AGENT_API_VERBS, u as AgentReadRequest } from "./session-CUc6d7aS.js";
-import { D as pullRequestKeyFromReference, c as TASK_TITLE_SOURCE_PRIORITY, o as PersistedTaskTitle } from "./config-BLeRKmn9.js";
-import { n as NO_OWN_WORKTREE_REASON, t as COMMAND_ROUTES } from "./session-routes--hrsvv7a.js";
+import { a as AgentAttentionRequest, d as AgentSendRequest, i as AgentAnswerRequest, l as AgentPullRequestRequest, m as AgentSpawnRequest, o as AgentCloseRequest, p as AgentSettingsRequest, s as AgentEditRequest, t as AGENT_API_VERBS, u as AgentReadRequest, w as RefinedTaskTitle, z as TASK_TITLE_CONTROL_CHARACTERS } from "./session-BwlLY_mv.js";
+import { T as pullRequestKeyFromReference, c as TASK_TITLE_SOURCE_PRIORITY, o as PersistedTaskTitle } from "./config-BqJTnPae.js";
+import { n as NO_OWN_WORKTREE_REASON, t as COMMAND_ROUTES } from "./session-routes-CviNvxcz.js";
 import path from "node:path";
 import crypto from "node:crypto";
 //#region shared/session-naming.ts
@@ -565,6 +565,7 @@ var REQUEST_PARSERS = Object.freeze({
 	board: parseEmptyBody,
 	push: parseEmptyBody,
 	edit: bodyParser(AgentEditRequest),
+	show: parseEmptyBody,
 	limits: parseEmptyBody,
 	review: parsePullRequestBody,
 	reviews: parseEmptyBody,
@@ -751,6 +752,11 @@ var AGENT_COMMAND_HELP = Object.freeze({
 		summary: "Open a text file for the operator to edit in the dashboard",
 		missingArgumentHint: "glimmervoid edit: this command needs a file path, for example \"glimmervoid edit drafts/post.md\""
 	},
+	show: {
+		usage: "show <path>... [--caption <text>]",
+		summary: "Show the operator an image, video or HTML page on this session's card",
+		missingArgumentHint: "glimmervoid show: this command needs a file path, for example \"glimmervoid show out/diagram.png --caption 'the new layout'\""
+	},
 	review: {
 		usage: "review <pr>",
 		summary: "Queue a team review of a pull request; the draft waits in the Reviews tab for the operator to post",

package/dist/chunks/{agent-setup-cli-7hG401Io.js → agent-setup-cli-BA_1AdhQ.js}

@@ -1,6 +1,6 @@
 import { a as isMissingFileError, r as errorMessage } from "./text-DoirglWV.js";
-import { a as classifyGrokHooksFile, o as renderGrokHooksFile, t as grok } from "./grok-Di4aQGre.js";
-import { p as writeTextAtomicSync } from "./json-file-DFCTvPjj.js";
+import { a as classifyGrokHooksFile, o as renderGrokHooksFile, t as grok } from "./grok-7jK8ZNtf.js";
+import { p as writeTextAtomicSync } from "./json-file-BjFK_eSH.js";
 import fs from "node:fs";
 import path from "node:path";
 //#region server/agent-setup-cli.ts

package/dist/chunks/{contracts-CucdticH.js → build-channel-qgKwNssc.js}

@@ -1,5 +1,5 @@
-import "./session-CUc6d7aS.js";
-import { C as ONBOARDING_STEPS, E as OPERATOR_SURFACES, T as OPERATOR_ACTIONS_BY_SURFACE, n as BUILTIN_AGENT_IDS, w as ONBOARDING_STEP_STATES, x as DASHBOARD_VIEWS } from "./config-BLeRKmn9.js";
+import "./session-BwlLY_mv.js";
+import { C as OPERATOR_ACTIONS_BY_SURFACE, S as ONBOARDING_STEP_STATES, n as BUILTIN_AGENT_IDS, w as OPERATOR_SURFACES, x as ONBOARDING_STEPS, y as DASHBOARD_VIEWS } from "./config-BqJTnPae.js";
 import { z } from "zod";
 //#region shared/contracts/telemetry.ts
 var TELEMETRY_ADAPTERS = Object.freeze([...BUILTIN_AGENT_IDS, "custom"]);
@@ -18,6 +18,7 @@ var SESSION_EXIT_KINDS = Object.freeze([
 var TEAM_REVIEW_SETTLED_OUTCOMES = Object.freeze([
 	"approve",
 	"comment",
+	"request-changes",
 	"approve-only",
 	"discarded"
 ]);
@@ -347,4 +348,37 @@ z.object({
 	projects: z.array(z.string()).optional()
 }).passthrough();
 //#endregion
-export { parseDataClientMessage as a, PendingCrashReport as c, TelemetryState as d, parseDataAttach as i, TELEMETRY_EVENT_SCHEMAS as l, HookEnvelope as n, DashboardTelemetryReport as o, DEEP_HISTORY_SCROLLBACK_LINES as r, FeatureFlagsResponse as s, HTTP_URL_RE as t, TELEMETRY_KILL_SWITCH_FLAG as u };
+//#region shared/build-channel.ts
+var RELEASE_VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:-next\.(\d+))?$/;
+function parseReleaseVersion(version) {
+	if (typeof version !== "string") return null;
+	const matched = RELEASE_VERSION_RE.exec(version.trim());
+	if (!matched) return null;
+	return {
+		core: [
+			Number(matched[1]),
+			Number(matched[2]),
+			Number(matched[3])
+		],
+		experimentalBuildNumber: matched[4] === void 0 ? null : Number(matched[4])
+	};
+}
+function compareExperimentalBuildNumbers(a, b) {
+	if (a === b) return 0;
+	if (a === null) return 1;
+	if (b === null) return -1;
+	return Math.sign(a - b);
+}
+function compareReleaseVersions(a, b) {
+	const left = parseReleaseVersion(a);
+	const right = parseReleaseVersion(b);
+	if (!left || !right) return 0;
+	for (let i = 0; i < 3; i += 1) if (left.core[i] !== right.core[i]) return Math.sign(left.core[i] - right.core[i]);
+	return compareExperimentalBuildNumbers(left.experimentalBuildNumber, right.experimentalBuildNumber);
+}
+function isExperimentalBuild(version) {
+	const parsed = parseReleaseVersion(version);
+	return parsed !== null && parsed.experimentalBuildNumber !== null;
+}
+//#endregion
+export { DEEP_HISTORY_SCROLLBACK_LINES as a, DashboardTelemetryReport as c, TELEMETRY_EVENT_SCHEMAS as d, TELEMETRY_KILL_SWITCH_FLAG as f, HookEnvelope as i, FeatureFlagsResponse as l, isExperimentalBuild as n, parseDataAttach as o, TelemetryState as p, HTTP_URL_RE as r, parseDataClientMessage as s, compareReleaseVersions as t, PendingCrashReport as u };