glimmervoid 0.39.0 → 0.40.0

package/README.md

@@ -76,7 +76,7 @@ Declare another agent under `customAgents` in `config.json` with an `id`, `label
 
 ## Features
 
-- **Focus view.** A rail of every session on the left, the selected session's live terminal in the middle, its changes on the right.
+- **Focus view.** A rail of every session on the left, the selected session's live terminal in the middle, its changes on the right. The top of the rail counts what needs you, and `Cmd/Alt+J` jumps straight to the next one from any tab.
 - **A worktree per agent.** Every session in a git repo gets its own worktree, so agents never step on your checkout or each other. Review the diff and merge with one click while the agent keeps working. A conflicted merge parks, and **Resolve in session** hands it back to the agent that wrote it.
 - **Exact status.** Hooks report every state change and the terminal title fills the gaps. The screen is never scraped ([how](#how-status-detection-works)).
 - **Notifications.** Browser notifications when a session needs input, finishes or fails, with your own alert sounds if you like (drop `.ogg`, `.mp3`, `.wav`, `.m4a` or `.webm` files into `~/.glimmervoid/sounds/`). Telegram covers you when no dashboard is open.

package/dist/bin/glimmervoid.js

@@ -2,11 +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 { a as packageRoot } from "../chunks/runtime-paths-BkeftE60.js";
-import { t as AGENT_API_VERBS } from "../chunks/session-D2EbiysG.js";
+import { t as AGENT_API_VERBS } from "../chunks/session-BwB43SCa.js";
 import { i as execSync } from "../chunks/child-process-safe-CbQnyh7D.js";
+import { r as agentCommandHelpLines } from "../chunks/agent-api-core-DDrJQEdE.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-DXozXVnb.js";
+import { i as parseCommandLine, r as gitDoctorRows, t as probeGitVersion } from "../chunks/git-version-CJQMfxtZ.js";
 import { i as guardrailsDoctorRows, r as probeGuardrailsDependencies } from "../chunks/guardrails-deps-CLxK4J-g.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";
@@ -35,12 +36,7 @@ Editor integration (Visions):
   visions relay       Run the Visions LSP relay on stdio (an editor's LSP client starts this)
 
 Inside a Glimmervoid session:
-  spawn <prompt>      Start a sibling session on that prompt
-  attention <note>    Flag this session as needing the operator
-  board               List the live sessions
-  push                Land this session's commits on the integration branch and push it
-  edit <path>         Open a text file for the operator to edit in the dashboard
-  limits              List which of these commands answer here and what the guardrails block
+${agentCommandHelpLines().join("\n")}
   ssh-sign            Sign a commit with the operator's forwarded ssh agent (git runs this)
 
 Options:
@@ -63,36 +59,37 @@ if (commandLine.kind === "version") {
 }
 if (commandLine.globalOptions.configPath) process.env.GLIMMERVOID_CONFIG = commandLine.globalOptions.configPath;
 if (commandLine.globalOptions.port) process.env.GLIMMERVOID_PORT = commandLine.globalOptions.port;
-var SUBCOMMAND_RUNNERS = new Map([
+var OWN_SUBCOMMAND_RUNNERS = [
 	["doctor", async () => {
 		await runDoctor();
 		return 0;
 	}],
 	["pair", async (subcommandArgs) => {
-		const { runPairCli } = await import("../chunks/pair-cli-D9DZBqk0.js");
+		const { runPairCli } = await import("../chunks/pair-cli-CsOVTQGJ.js");
 		return runPairCli(subcommandArgs);
 	}],
 	["agent", async (subcommandArgs) => {
-		const { runAgentSetupCli } = await import("../chunks/agent-setup-cli-C1nFdgFg.js");
+		const { runAgentSetupCli } = await import("../chunks/agent-setup-cli-CeBBwKuL.js");
 		return runAgentSetupCli(subcommandArgs);
 	}],
 	["settings", async (subcommandArgs) => {
-		const { runSettingsCommand } = await import("../chunks/settings-cli-DP4t-I9U.js");
-		return runSettingsCommand(subcommandArgs);
+		const { runSettingsCli } = await import("../chunks/settings-cli-DkkbK-dj.js");
+		return runSettingsCli(subcommandArgs);
 	}],
 	["visions", async (subcommandArgs) => {
 		const { runVisionsCli } = await import("../chunks/visions-cli-CYujESdJ.js");
 		return runVisionsCli(subcommandArgs);
 	}],
 	["ssh-sign", async (subcommandArgs) => {
-		const { runSshSignCli } = await import("../chunks/ssh-sign-cli-D2RIs-iN.js");
+		const { runSshSignCli } = await import("../chunks/ssh-sign-cli-CYeKRevK.js");
 		return runSshSignCli(subcommandArgs);
-	}],
-	...AGENT_API_VERBS.map((verb) => [verb, async (subcommandArgs, subcommandName) => {
-		const { runAgentApiCli } = await import("../chunks/agent-api-cli-PfCov-qb.js");
-		return runAgentApiCli([subcommandName, ...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-BBech5lF.js");
+	return runAgentApiCli([subcommandName, ...subcommandArgs]);
+}])]);
 var AGENT_INSTALL_COMMAND_BY_ID = {
 	"claude-code": "npm install -g @anthropic-ai/claude-code",
 	codex: "npm install -g @openai/codex"
@@ -104,7 +101,7 @@ function missingAgentText(agentId) {
 }
 async function printSessionLimits() {
 	if (!process.env["GLIMMERVOID_AGENT_URL"]) return;
-	const { sessionLimitsHelpLines } = await import("../chunks/agent-api-cli-PfCov-qb.js");
+	const { sessionLimitsHelpLines } = await import("../chunks/agent-api-cli-BBech5lF.js");
 	const limitsLines = await sessionLimitsHelpLines();
 	console.log(`\n${limitsLines.join("\n")}`);
 }
@@ -161,7 +158,7 @@ async function readDeclaredCustomAgents() {
 		declared: [],
 		error: null
 	};
-	const { loadConfigFile } = await import("../chunks/config-store-8Z9vkWvf.js");
+	const { loadConfigFile } = await import("../chunks/config-store-BZpN2djp.js");
 	try {
 		const loaded = loadConfigFile(decided.path, { exitOnError: false });
 		if (!loaded.config) return {
@@ -237,7 +234,7 @@ async function runDoctor() {
 	}
 	switchSection("Agents");
 	try {
-		const { listAgentIds, describeAgentResolvability, setCustomAgents } = await import("../chunks/adapters-Buu6yI71.js");
+		const { listAgentIds, describeAgentResolvability, setCustomAgents } = await import("../chunks/adapters-CXQfLoyj.js");
 		const declaredCustomAgents = await readDeclaredCustomAgents();
 		if (declaredCustomAgents.error) line("config", declaredCustomAgents.error);
 		setCustomAgents(declaredCustomAgents.declared);
@@ -245,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-C1nFdgFg.js");
+		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-CeBBwKuL.js");
 		const grokSetup = inspectGrokAgentSetup();
 		line("grok hook setup", `${grokSetup.classification}: ${grokSetup.filePath}`);
 	} catch (err) {
@@ -262,7 +259,7 @@ async function runDoctor() {
 	try {
 		const { resolvePackageBin } = await import("../chunks/runtime-paths-DSmormp7.js");
 		const { execFileSync } = await import("../chunks/child-process-safe-ChRmWAJP.js");
-		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-C1nFdgFg.js");
+		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-CeBBwKuL.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-B9tP9MXC.js → adapters-B6tbX3Aj.js}

@@ -1,12 +1,13 @@
 import { o as relayPath } from "./runtime-paths-BkeftE60.js";
 import { r as execFileSync } from "./child-process-safe-CbQnyh7D.js";
+import "./control-messages-DpBaniJi.js";
+import { o as supervisionLine } from "./session-routes-DNJzsckH.js";
 import { n as resolveAgentCommand, t as buildAgentSpawnCommand } from "./spawn-command-Cc40FiZI.js";
 import { s as rawTextOr } from "./coerce-NSst8oRP.js";
 import { r as nextBackoffMs } from "./backoff-DjVpfHk7.js";
-import { l as supervisionLine } from "./session-routes-BQAZzMKZ.js";
-import { i as isSpinnerChar, n as classifyAgentTitle, r as isBrailleChar, s as buildAgentEnv, t as grok } from "./grok-DeGAXgZF.js";
+import { i as isSpinnerChar, n as classifyAgentTitle, r as isBrailleChar, s as buildAgentEnv, t as grok } from "./grok-BLzhApwT.js";
 import { t as buildHookCommand } from "./hook-command-core-qTNK-xMF.js";
-import "./contracts-DYQW11de.js";
+import "./contracts-CloExMlS.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";

package/dist/chunks/{adapters-Buu6yI71.js → adapters-CXQfLoyj.js}

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

package/dist/chunks/agent-api-cli-BBech5lF.js

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

package/dist/chunks/{agent-api-cli-2_RwTTTJ.js → agent-api-cli-BNHJTmNW.js}

@@ -1,16 +1,20 @@
 import { t as errorCode } from "./text-DoirglWV.js";
-import { n as AGENT_URL_ENV, o as AgentLimitsReply } from "./session-D2EbiysG.js";
+import { n as AGENT_URL_ENV, o as AgentLimitsReply } from "./session-BwB43SCa.js";
+import { i as formatSessionLimits } from "./session-routes-DNJzsckH.js";
+import { l as isAgentApiVerb, t as AGENT_COMMAND_HELP } from "./agent-api-core-DDrJQEdE.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 { a as formatSessionLimits } from "./session-routes-BQAZzMKZ.js";
-import { l as isAgentApiVerb } from "./agent-api-core-D2HLgBEe.js";
 import path from "node:path";
 import http from "node:http";
 //#region server/agent-api-cli.ts
 var AGENT_PATH_PREFIX = "/agent/";
 var HELP_LIMITS_TIMEOUT_MS = 2e3;
 var HELP_LIMITS_UNKNOWN_LINE = "This session: Glimmervoid did not report its limits, so run glimmervoid limits to see why";
+function pullRequestBody(rest) {
+	const pullRequest = rest.join(" ").trim();
+	return pullRequest ? { pr: pullRequest } : null;
+}
 var BODY_BUILDERS = {
 	spawn: (rest) => {
 		const prompt = rest.join(" ").trim();
@@ -26,7 +30,15 @@ var BODY_BUILDERS = {
 		const docPath = rest.join(" ").trim();
 		return docPath ? { path: path.resolve(docPath) } : null;
 	},
-	limits: () => ({})
+	limits: () => ({}),
+	review: pullRequestBody,
+	reviews: () => ({}),
+	prs: () => ({}),
+	"link-pr": pullRequestBody,
+	settings: ([command, settingPath]) => ({
+		command,
+		...settingPath === void 0 ? {} : { path: settingPath }
+	})
 };
 function bodySaysOk(text) {
 	try {
@@ -148,21 +160,12 @@ async function runAgentApiCli(args) {
 	}
 	const body = BODY_BUILDERS[verb](args.slice(1));
 	if (!body) {
-		if (verb === "edit") {
-			console.error("glimmervoid edit: this command needs a file path, for example \"glimmervoid edit drafts/post.md\"");
-			return 1;
-		}
-		console.error(`glimmervoid ${verb}: this command needs text, for example "glimmervoid ${verb} check the failing test"`);
+		console.error(AGENT_COMMAND_HELP[verb].missingArgumentHint ?? `glimmervoid ${verb}: this command needs an argument`);
 		return 1;
 	}
-	const rawUrl = process.env[AGENT_URL_ENV];
-	if (!rawUrl) {
-		console.error(`glimmervoid: ${AGENT_URL_ENV} is not set, so this is not a Glimmervoid session`);
-		return 1;
-	}
-	const target = verbEndpoint(rawUrl, verb);
+	const target = sessionEndpoint(verb);
 	if (!target.ok) {
-		console.error(`glimmervoid: ${AGENT_URL_ENV} must be a loopback http url under ${AGENT_PATH_PREFIX}, so nothing was sent`);
+		console.error(target.error);
 		return 1;
 	}
 	const reply = await postToAgentIngress({
@@ -173,5 +176,31 @@ async function runAgentApiCli(args) {
 	console.log(printableReply(verb, reply.text));
 	return reply.hasSuccessStatus && bodySaysOk(reply.text) ? 0 : 1;
 }
+function sessionEndpoint(verb) {
+	const rawUrl = process.env[AGENT_URL_ENV];
+	if (!rawUrl) return {
+		ok: false,
+		error: `glimmervoid: ${AGENT_URL_ENV} is not set, so this is not a Glimmervoid session`
+	};
+	const target = verbEndpoint(rawUrl, verb);
+	if (!target.ok) return {
+		ok: false,
+		error: `glimmervoid: ${AGENT_URL_ENV} must be a loopback http url under ${AGENT_PATH_PREFIX}, so nothing was sent`
+	};
+	return target;
+}
+async function askAgentApi(verb, body) {
+	const target = sessionEndpoint(verb);
+	if (!target.ok) return {
+		ok: false,
+		error: target.error
+	};
+	const reply = await postToAgentIngress({
+		endpoint: target.endpoint,
+		token: target.token,
+		body
+	});
+	return parseJsonOrNull(reply.text);
+}
 //#endregion
-export { runAgentApiCli as n, sessionLimitsHelpLines as r, postToAgentIngress as t };
+export { sessionLimitsHelpLines as i, postToAgentIngress as n, runAgentApiCli as r, askAgentApi as t };

package/dist/chunks/agent-api-core-DDrJQEdE.js

@@ -0,0 +1,304 @@
+import { a as AgentEditRequest, i as AgentAttentionRequest, l as AgentSettingsRequest, s as AgentPullRequestRequest, t as AGENT_API_VERBS, u as AgentSpawnRequest } from "./session-BwB43SCa.js";
+import { a as pullRequestKeyFromReference } from "./control-messages-DpBaniJi.js";
+import { n as NO_OWN_WORKTREE_REASON, t as COMMAND_ROUTES } from "./session-routes-DNJzsckH.js";
+import crypto from "node:crypto";
+var MAX_SPAWNS_IN_FLIGHT = 1;
+var REFUSAL_REASON = "unknown session";
+var INVALID_BODY_STATUS = 400;
+var ROLE_REFUSED_STATUS = 403;
+var PUSH_REFUSED_STATUS = 409;
+var PUSH_REFUSAL_COPY = Object.freeze({
+	"no-worktree": () => NO_OWN_WORKTREE_REASON,
+	"merge-in-progress": () => "a merge for this session is already running, so try again when it ends",
+	"not-continuable": () => "this session cannot be merged in its current state",
+	destroyed: () => "this session is ending",
+	"nothing-to-commit": () => "no commit on this branch is missing from the integration branch, so commit your work first",
+	"rebase-conflict": ({ base, conflicts = [] }) => `this branch conflicts with ${base} in ${conflicts.join(", ") || "one or more files"}, so rebase onto ${base}, resolve the conflicts, commit, then push again`,
+	"not-fast-forward": ({ base }) => `${base} could not be fast-forwarded to this branch, and a push is never forced`,
+	"base-diverged": ({ base }) => `the local ${base} and origin/${base} have diverged, which the operator has to reconcile`
+});
+function tokensMatch(presented, expected) {
+	if (presented.length !== expected.length) return false;
+	try {
+		return crypto.timingSafeEqual(Buffer.from(presented, "utf8"), Buffer.from(expected, "utf8"));
+	} catch {
+		return false;
+	}
+}
+function refused() {
+	return {
+		ok: false,
+		status: 404,
+		reason: REFUSAL_REASON
+	};
+}
+function decideAgentRequest({ sessionId, presentedToken, expectedToken, isLoopback }) {
+	if (!isLoopback) return refused();
+	if (!sessionId) return refused();
+	if (!expectedToken) return refused();
+	if (!presentedToken) return refused();
+	if (!tokensMatch(presentedToken, expectedToken)) return refused();
+	return { ok: true };
+}
+function decideSpawnAllowance({ liveChildren, lifetimeSpawns, inFlight }) {
+	if (inFlight >= MAX_SPAWNS_IN_FLIGHT) return {
+		ok: false,
+		status: 429,
+		reason: "a spawn is already in flight"
+	};
+	if (liveChildren >= 3) return {
+		ok: false,
+		status: 429,
+		reason: `at most 3 spawned sessions may be live at once`
+	};
+	if (lifetimeSpawns >= 10) return {
+		ok: false,
+		status: 429,
+		reason: `this session has used its 10 spawns`
+	};
+	return { ok: true };
+}
+function describeRoleRefusal(verb, caller) {
+	const route = COMMAND_ROUTES[verb](caller);
+	if (route.answers) return null;
+	if (route.code) return {
+		status: PUSH_REFUSED_STATUS,
+		body: {
+			ok: false,
+			reason: route.code,
+			error: route.reason
+		}
+	};
+	return {
+		status: ROLE_REFUSED_STATUS,
+		body: {
+			ok: false,
+			error: route.reason
+		}
+	};
+}
+function isAgentApiVerb(verb) {
+	return AGENT_API_VERBS.includes(verb);
+}
+function refuseInvalidBody(issues) {
+	return {
+		ok: false,
+		status: INVALID_BODY_STATUS,
+		error: issues[0]?.message || "invalid request"
+	};
+}
+function bodyParser(schema) {
+	return (payload) => {
+		const parsed = schema.safeParse(payload);
+		if (!parsed.success) return refuseInvalidBody(parsed.error.issues);
+		return {
+			ok: true,
+			request: parsed.data
+		};
+	};
+}
+var parseEmptyBody = () => ({
+	ok: true,
+	request: {}
+});
+var parsePullRequestBody = (payload) => {
+	const parsed = AgentPullRequestRequest.safeParse(payload);
+	if (!parsed.success) return refuseInvalidBody(parsed.error.issues);
+	const pullRequestKey = pullRequestKeyFromReference(parsed.data.pr);
+	if (!pullRequestKey) return {
+		ok: false,
+		status: INVALID_BODY_STATUS,
+		error: "pr must be a GitHub pull request url or owner/repo#number"
+	};
+	return {
+		ok: true,
+		request: { pullRequestKey }
+	};
+};
+var REQUEST_PARSERS = Object.freeze({
+	spawn: bodyParser(AgentSpawnRequest),
+	attention: bodyParser(AgentAttentionRequest),
+	board: parseEmptyBody,
+	push: parseEmptyBody,
+	edit: bodyParser(AgentEditRequest),
+	limits: parseEmptyBody,
+	review: parsePullRequestBody,
+	reviews: parseEmptyBody,
+	prs: parseEmptyBody,
+	"link-pr": parsePullRequestBody,
+	settings: bodyParser(AgentSettingsRequest)
+});
+function parseAgentVerb(verb, payload) {
+	if (!isAgentApiVerb(verb)) return {
+		ok: false,
+		status: 404,
+		error: REFUSAL_REASON
+	};
+	const parsed = REQUEST_PARSERS[verb](payload);
+	if (!parsed.ok) return parsed;
+	return {
+		ok: true,
+		verb,
+		request: parsed.request
+	};
+}
+function describePushLanding(landing) {
+	if (!landing.merged) {
+		const reason = landing.reason || "unknown";
+		const explain = PUSH_REFUSAL_COPY[reason];
+		return {
+			status: PUSH_REFUSED_STATUS,
+			body: {
+				ok: false,
+				reason,
+				error: explain ? explain(landing) : `the merge stopped: ${reason}`
+			}
+		};
+	}
+	if (landing.pushed) return {
+		status: 200,
+		body: {
+			ok: true,
+			landedOn: landing.base ?? null,
+			pushed: true
+		}
+	};
+	return {
+		status: 200,
+		body: {
+			ok: true,
+			landedOn: landing.base ?? null,
+			pushed: false,
+			note: "landed locally and nothing was pushed, because the repository has no origin remote or origin did not take a fast-forward"
+		}
+	};
+}
+function projectReviews({ configured, reason, inFlight, queued, drafts }) {
+	const identity = ({ key, title, url, author }) => ({
+		key,
+		title,
+		url,
+		author
+	});
+	return {
+		ok: true,
+		configured,
+		reason: reason ?? null,
+		reviewing: inFlight.map((review) => ({
+			...identity(review),
+			phase: review.phase
+		})),
+		queued: queued.map(identity),
+		drafts: drafts.map((draft) => ({
+			...identity(draft),
+			status: draft.status,
+			verdict: draft.verdict,
+			summary: draft.summary,
+			comments: draft.comments.length,
+			isOutOfDate: draft.liveHead !== void 0 && draft.liveHead !== draft.reviewedHead
+		}))
+	};
+}
+function projectMyPrs(snapshot) {
+	if (!snapshot) return {
+		ok: true,
+		configured: false,
+		prs: []
+	};
+	return {
+		ok: true,
+		configured: snapshot.configured,
+		prs: snapshot.prs.map((pr) => ({
+			key: pr.key,
+			title: pr.title,
+			url: pr.url,
+			state: pr.state,
+			isDraft: pr.isDraft,
+			stage: pr.stage,
+			reviewDecision: pr.reviewDecision,
+			approvals: pr.approvals,
+			unresolvedThreads: pr.unresolvedThreads,
+			behindBy: pr.behindBy,
+			mergeable: pr.mergeable,
+			isInMergeQueue: pr.isInMergeQueue,
+			checks: {
+				state: pr.checks.state,
+				failing: pr.checks.failing
+			}
+		}))
+	};
+}
+function deriveChildSessionName(parentName, existingNames) {
+	const base = `${String(parentName || "").trim() || "session"} agent`;
+	const taken = new Set(existingNames);
+	let candidate = base;
+	let suffix = 1;
+	while (taken.has(candidate)) {
+		suffix += 1;
+		candidate = `${base} ${suffix}`;
+	}
+	return candidate;
+}
+var USAGE_COLUMN_WIDTH = 20;
+var AGENT_COMMAND_HELP = Object.freeze({
+	spawn: {
+		usage: "spawn <prompt>",
+		summary: "Start a sibling session on that prompt",
+		missingArgumentHint: "glimmervoid spawn: this command needs text, for example \"glimmervoid spawn check the failing test\""
+	},
+	attention: {
+		usage: "attention <note>",
+		summary: "Flag this session as needing the operator",
+		missingArgumentHint: "glimmervoid attention: this command needs text, for example \"glimmervoid attention check the failing test\""
+	},
+	board: {
+		usage: "board",
+		summary: "List the live sessions",
+		missingArgumentHint: null
+	},
+	push: {
+		usage: "push",
+		summary: "Land this session's commits on the integration branch and push it",
+		missingArgumentHint: null
+	},
+	edit: {
+		usage: "edit <path>",
+		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\""
+	},
+	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",
+		missingArgumentHint: "glimmervoid review: this command needs a pull request, for example \"glimmervoid review https://github.com/acme/app/pull/12\" or \"glimmervoid review acme/app#12\""
+	},
+	reviews: {
+		usage: "reviews",
+		summary: "List the Reviews tab: reviews running, queued and drafted",
+		missingArgumentHint: null
+	},
+	prs: {
+		usage: "prs",
+		summary: "List the operator's open pull requests with their checks, reviews and merge state",
+		missingArgumentHint: null
+	},
+	"link-pr": {
+		usage: "link-pr <pr>",
+		summary: "Link a pull request to this session's card",
+		missingArgumentHint: "glimmervoid link-pr: this command needs a pull request, for example \"glimmervoid link-pr acme/app#12\""
+	},
+	settings: {
+		usage: "settings list|get",
+		summary: "Read Glimmervoid's settings; a secret shows only as configured or not",
+		missingArgumentHint: null
+	},
+	limits: {
+		usage: "limits",
+		summary: "List which of these commands answer here and what the guardrails block",
+		missingArgumentHint: null
+	}
+});
+function agentCommandHelpLines() {
+	return Object.values(AGENT_COMMAND_HELP).map(({ usage, summary }) => `  ${usage.padEnd(USAGE_COLUMN_WIDTH)}${summary}`);
+}
+//#endregion
+export { decideSpawnAllowance as a, describeRoleRefusal as c, projectMyPrs as d, projectReviews as f, decideAgentRequest as i, isAgentApiVerb as l, REFUSAL_REASON as n, deriveChildSessionName as o, agentCommandHelpLines as r, describePushLanding as s, AGENT_COMMAND_HELP as t, parseAgentVerb as u };

package/dist/chunks/{agent-setup-cli-C1nFdgFg.js → agent-setup-cli-CeBBwKuL.js}

@@ -1,5 +1,5 @@
 import { a as isMissingFileError, r as errorMessage } from "./text-DoirglWV.js";
-import { a as classifyGrokHooksFile, o as renderGrokHooksFile, t as grok } from "./grok-DeGAXgZF.js";
+import { a as classifyGrokHooksFile, o as renderGrokHooksFile, t as grok } from "./grok-BLzhApwT.js";
 import { p as writeTextAtomicSync } from "./json-file-DFCTvPjj.js";
 import fs from "node:fs";
 import path from "node:path";

package/dist/chunks/config-store-BZpN2djp.js

@@ -0,0 +1 @@
+export { s as loadConfigFile } from "./config-store-DqMScSdg.js";

package/dist/chunks/{config-store-n23JDU4E.js → config-store-DqMScSdg.js}

@@ -1,9 +1,10 @@
 import { n as errorLabel, r as errorMessage } from "./text-DoirglWV.js";
 import { n as equalsIgnoringCaseOnWindows } from "./paths-Bu4eH1Yd.js";
+import { $ as USAGE_BUDGET_RANGE, A as FLYING_ANIMALS_DEFAULTS, B as POSTHOG_FIX_TIMEOUT_RANGE, F as MEMORY_RESERVE_MB_RANGE, I as NON_NEGATIVE_NUMBER_RANGE, J as POSTHOG_TRAFFIC_MIN_USERS_RANGE, K as POSTHOG_TRAFFIC_BASELINE_RANGE, L as PORT_RANGE, M as FLYING_ANIMALS_GAP_RANGE, N as FLYING_ANIMALS_SCALE_RANGE, P as KEEP_MERGEABLE_TIMEOUT_MINUTES_RANGE, Q as TASK_TITLE_TIMEOUT_RANGE, R as POSITIVE_NUMBER_RANGE, Y as POSTHOG_TRAFFIC_MULTIPLIER_RANGE, Z as REPLAY_BUFFER_KB_RANGE, et as USAGE_INTEGER_RANGES, j as FLYING_ANIMALS_DURATION_RANGE, k as CHANGE_MAP_NARRATOR_TIMEOUT_RANGE, lt as WORKFLOWS_MAX_ACTIONS_PER_POLL_RANGE, nt as USAGE_SCAN_INTERVAL_RANGE, tt as USAGE_RETAIN_DAYS_RANGE, ut as WORKFLOWS_MAX_CONCURRENT_SESSIONS_RANGE } from "./control-messages-DpBaniJi.js";
 import { n as glimmervoidHomeDir$1, t as decideConfigPath } from "./config-path-core-DFt-TemS.js";
 import { n as isRecord } from "./coerce-NSst8oRP.js";
 import { d as writeJsonAtomicSync, f as writeTextAtomic, p as writeTextAtomicSync } from "./json-file-DFCTvPjj.js";
-import { $ as Config, At as POSTHOG_TRAFFIC_MULTIPLIER_RANGE, Ct as MEMORY_RESERVE_MB_RANGE, Dt as POSTHOG_FIX_TIMEOUT_RANGE, Et as POSITIVE_NUMBER_RANGE, Ft as USAGE_RETAIN_DAYS_RANGE, G as FeatureFlagsResponse, It as USAGE_SCAN_INTERVAL_RANGE, J as TELEMETRY_KILL_SWITCH_FLAG, Lt as WORKFLOWS_MAX_ACTIONS_PER_POLL_RANGE, Mt as TASK_TITLE_TIMEOUT_RANGE, Nt as USAGE_BUDGET_RANGE, Ot as POSTHOG_TRAFFIC_BASELINE_RANGE, Pt as USAGE_INTEGER_RANGES, Rt as WORKFLOWS_MAX_CONCURRENT_SESSIONS_RANGE, St as KEEP_MERGEABLE_TIMEOUT_MINUTES_RANGE, Tt as PORT_RANGE, X as AGENT_ID_SHAPE_MESSAGE, Z as BUILTIN_AGENT_IDS, _t as CHANGE_MAP_NARRATOR_TIMEOUT_RANGE, at as BranchGcFileSettings, bt as FLYING_ANIMALS_GAP_RANGE, ct as UPDATE_CHANNELS, gt as normalizeLegacyConfigNumbers, it as configIssueMessage, jt as REPLAY_BUFFER_KB_RANGE, kt as POSTHOG_TRAFFIC_MIN_USERS_RANGE, mt as USAGE_COST_MODES, nt as RUNTIME_CONFIG_SCALAR_KEYS, ot as CHANGE_MAP_NARRATOR_ENGINES, st as POST_TURN_CHECK_MODES, vt as FLYING_ANIMALS_DEFAULTS, wt as NON_NEGATIVE_NUMBER_RANGE, xt as FLYING_ANIMALS_SCALE_RANGE, yt as FLYING_ANIMALS_DURATION_RANGE } from "./contracts-DYQW11de.js";
+import { C as UPDATE_CHANNELS, E as normalizeLegacyConfigNumbers, S as POST_TURN_CHECK_MODES, _ as RUNTIME_CONFIG_SCALAR_KEYS, b as BranchGcFileSettings, d as AGENT_ID_SHAPE_MESSAGE, f as BUILTIN_AGENT_IDS, l as TELEMETRY_KILL_SWITCH_FLAG, m as Config, o as FeatureFlagsResponse, w as USAGE_COST_MODES, x as CHANGE_MAP_NARRATOR_ENGINES, y as configIssueMessage } from "./contracts-CloExMlS.js";
 import fs from "node:fs";
 import path from "node:path";
 import os from "node:os";
@@ -1014,6 +1015,22 @@ var SECTIONS = Object.freeze([
 				defaultValue: false,
 				...MACHINE_NOW
 			},
+			{
+				id: "zen-view",
+				path: "zenView",
+				title: "Zen view (experimental)",
+				description: "Add a Zen tab that shows no terminal until a session needs you, then shows only that session and what it needs.",
+				control: "toggle",
+				keywords: [
+					"experimental",
+					"calm",
+					"focus",
+					"attention",
+					"needs you"
+				],
+				defaultValue: false,
+				...MACHINE_NOW
+			},
 			{
 				id: "streamer-mode",
 				path: "streamerMode",
@@ -3352,6 +3369,7 @@ var DEFAULT_CONFIG = {
 	debugMode: false,
 	conversationView: false,
 	streamerMode: false,
+	zenView: false,
 	detectBackgroundAgents: true,
 	detectScheduledWakeups: true,
 	replayBufferKB: 512,
@@ -3788,6 +3806,7 @@ function createConfigStore({ settingsDefaults } = {}) {
 			debugMode: config.debugMode ?? effectiveDefaults.debugMode,
 			conversationView: config.conversationView ?? effectiveDefaults.conversationView,
 			streamerMode: config.streamerMode ?? effectiveDefaults.streamerMode,
+			zenView: config.zenView ?? effectiveDefaults.zenView,
 			detectBackgroundAgents: config.detectBackgroundAgents ?? effectiveDefaults.detectBackgroundAgents,
 			recordSignals: config.recordSignals ?? effectiveDefaults.recordSignals,
 			trace: pickBlock("trace", {