glimmervoid 0.34.1 → 0.35.0

package/dist/bin/glimmervoid.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 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-BPoxENmK.js";
-import { t as AGENT_API_VERBS } from "../chunks/session-C7rstCmA.js";
-import { i as execSync } from "../chunks/child-process-safe-DDELk9XC.js";
+import { a as packageRoot } from "../chunks/runtime-paths-BkeftE60.js";
+import { t as AGENT_API_VERBS } from "../chunks/session-D6xXN0UU.js";
+import { i as execSync } from "../chunks/child-process-safe-CbQnyh7D.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 sandboxDoctorRows, r as probeSandboxDependencies } from "../chunks/sandbox-deps-C63o3mZs.js";
-import { r as gitDoctorRows, t as probeGitVersion } from "../chunks/git-version-CrLW4a6r.js";
+import { i as sandboxDoctorRows, r as probeSandboxDependencies } from "../chunks/sandbox-deps-CWiH1d1w.js";
+import { r as gitDoctorRows, t as probeGitVersion } from "../chunks/git-version-CUcDtF5k.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";
 import path from "node:path";
@@ -109,6 +109,7 @@ Commands:
   board             From inside a Glimmervoid session, list the live sessions
   push              From inside a Glimmervoid session, land its commits on the integration branch and push it
   edit <path>       From inside a Glimmervoid session, surface a text file for the operator to edit in the dashboard
+  limits            From inside a Glimmervoid session, list which of these commands answer and what its guardrails block
   ssh-sign          What git runs inside a Glimmervoid session to sign a commit with the operator's forwarded ssh agent
   kg [command]      Experimental typed knowledge and task graph (Settings > Lanes > Knowledge graph)
 
@@ -121,6 +122,8 @@ Options:
 var commandLine = parseCommandLine(args);
 if (commandLine.kind === "help") {
 	console.log(USAGE);
+	await printSessionLimits();
+	await drainOutput();
 	process.exit(0);
 }
 if (commandLine.kind === "version") {
@@ -135,38 +138,47 @@ var SUBCOMMAND_RUNNERS = new Map([
 		return 0;
 	}],
 	["pair", async (subcommandArgs) => {
-		const { runPairCli } = await import("../chunks/pair-cli-CI848omy.js");
+		const { runPairCli } = await import("../chunks/pair-cli-Dcyzv3In.js");
 		return runPairCli(subcommandArgs);
 	}],
 	["agent", async (subcommandArgs) => {
-		const { runAgentSetupCli } = await import("../chunks/agent-setup-cli-CFielF2o.js");
+		const { runAgentSetupCli } = await import("../chunks/agent-setup-cli-BTAFcckd.js");
 		return runAgentSetupCli(subcommandArgs);
 	}],
 	["kg", async (subcommandArgs) => {
-		const { runKnowledgeGraphCommand } = await import("../chunks/knowledge-graph-cli-BBE3R9DJ.js");
+		const { runKnowledgeGraphCommand } = await import("../chunks/knowledge-graph-cli-Rj5nj87L.js");
 		return runKnowledgeGraphCommand(subcommandArgs);
 	}],
 	["visions", async (subcommandArgs) => {
-		const { runVisionsCli } = await import("../chunks/visions-cli-BhFdym5n.js");
+		const { runVisionsCli } = await import("../chunks/visions-cli-CYujESdJ.js");
 		return runVisionsCli(subcommandArgs);
 	}],
 	["ssh-sign", async (subcommandArgs) => {
-		const { runSshSignCli } = await import("../chunks/ssh-sign-cli-SWtTF00D.js");
+		const { runSshSignCli } = await import("../chunks/ssh-sign-cli-DPHpT22B.js");
 		return runSshSignCli(subcommandArgs);
 	}],
 	...AGENT_API_VERBS.map((verb) => [verb, async (subcommandArgs, subcommandName) => {
-		const { runAgentApiCli } = await import("../chunks/agent-api-cli-CRJYxzVU.js");
+		const { runAgentApiCli } = await import("../chunks/agent-api-cli-CRj_FYbz.js");
 		return runAgentApiCli([subcommandName, ...subcommandArgs]);
 	}])
 ]);
+async function printSessionLimits() {
+	if (!process.env["GLIMMERVOID_AGENT_URL"]) return;
+	const { sessionLimitsHelpLines } = await import("../chunks/agent-api-cli-CRj_FYbz.js");
+	const limitsLines = await sessionLimitsHelpLines();
+	console.log(`\n${limitsLines.join("\n")}`);
+}
 function flushStream(stream) {
 	return new Promise((resolve) => {
 		stream.once("error", () => resolve());
 		stream.write("", () => resolve());
 	});
 }
-async function exitAfterOutputDrains(exitCode) {
+async function drainOutput() {
 	await Promise.all([flushStream(process.stdout), flushStream(process.stderr)]);
+}
+async function exitAfterOutputDrains(exitCode) {
+	await drainOutput();
 	process.exit(exitCode);
 }
 async function runSubcommandToExitCode(runSubcommand, subcommandArgs, subcommandName) {
@@ -209,7 +221,7 @@ async function readDeclaredCustomAgents() {
 		declared: [],
 		error: null
 	};
-	const { loadConfigFile } = await import("../chunks/config-store-DwTxLe8Y.js");
+	const { loadConfigFile } = await import("../chunks/config-store-BeIxAZNn.js");
 	try {
 		const loaded = loadConfigFile(decided.path, { exitOnError: false });
 		if (!loaded.config) return {
@@ -285,7 +297,7 @@ async function runDoctor() {
 	}
 	switchSection("Agents");
 	try {
-		const { listAgentIds, describeAgentResolvability, setCustomAgents } = await import("../chunks/adapters-CgbcceU3.js");
+		const { listAgentIds, describeAgentResolvability, setCustomAgents } = await import("../chunks/adapters-B37wqNti.js");
 		const declaredCustomAgents = await readDeclaredCustomAgents();
 		if (declaredCustomAgents.error) line("config", declaredCustomAgents.error);
 		setCustomAgents(declaredCustomAgents.declared);
@@ -293,7 +305,7 @@ async function runDoctor() {
 			const { label, path: resolvedPath } = describeAgentResolvability(id);
 			line(`${id} (${label})`, resolvedPath ?? "not found on PATH");
 		}
-		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-CFielF2o.js");
+		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-BTAFcckd.js");
 		const grokSetup = inspectGrokAgentSetup();
 		line("grok hook setup", `${grokSetup.classification}: ${grokSetup.filePath}`);
 	} catch (err) {
@@ -301,16 +313,16 @@ async function runDoctor() {
 	}
 	switchSection("rtk");
 	try {
-		const { getRtkPath } = await import("../chunks/rtk-resolver-CIVLE_xk.js");
+		const { getRtkPath } = await import("../chunks/rtk-resolver-SWU5VVM7.js");
 		line("rtk", getRtkPath() || "not installed (Glimmervoid installs it when the rtk setting is on)");
 	} catch (err) {
 		line("rtk", `probe failed: ${firstLine(errorText(err))}`);
 	}
 	switchSection("Sane YOLO");
 	try {
-		const { resolvePackageBin } = await import("../chunks/runtime-paths-DU5jBEEO.js");
-		const { execFileSync } = await import("../chunks/child-process-safe-B3zcPdFM.js");
-		const { inspectGrokAgentSetup } = await import("../chunks/agent-setup-cli-CFielF2o.js");
+		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-BTAFcckd.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-B37wqNti.js

@@ -0,0 +1 @@
+export { a as describeAgentResolvability, l as listAgentIds, d as setCustomAgents } from "./adapters-CADejSpq.js";

package/dist/chunks/{adapters-D-cRFZ_Q.js → adapters-CADejSpq.js}

@@ -1,13 +1,16 @@
-import { o as relayPath } from "./runtime-paths-BPoxENmK.js";
-import { D as firstDetailLine, O as toolDetailFieldValue, f as PendingPromptQuestion, u as PROMPT_DETAIL_HIDDEN_CHARACTERS } from "./session-C7rstCmA.js";
-import { r as execFileSync } from "./child-process-safe-DDELk9XC.js";
+import { o as relayPath } from "./runtime-paths-BkeftE60.js";
+import { A as toolDetailFieldValue, d as PROMPT_DETAIL_HIDDEN_CHARACTERS, k as firstDetailLine, p as PendingPromptQuestion } from "./session-D6xXN0UU.js";
+import { r as execFileSync } from "./child-process-safe-CbQnyh7D.js";
 import { n as resolveAgentCommand, t as buildAgentSpawnCommand } from "./spawn-command-Cc40FiZI.js";
-import { n as isRecord } from "./coerce-NSst8oRP.js";
-import { c as buildAgentEnv, i as isSpinnerChar, n as classifyAgentTitle, r as isBrailleChar, t as grok } from "./grok-BYKnBgdr.js";
+import { n as isRecord, s as rawTextOr } from "./coerce-NSst8oRP.js";
+import { r as nextBackoffMs } from "./backoff-DjVpfHk7.js";
+import { l as supervisionLine } from "./session-routes-BYy3am9m.js";
+import { c as buildAgentEnv, i as isSpinnerChar, n as classifyAgentTitle, r as isBrailleChar, t as grok } from "./grok-KKgdSe-7.js";
 import { t as buildHookCommand } from "./hook-command-core-DclEoE9e.js";
-import "./contracts-DZV9H8px.js";
+import "./contracts-DjIgIuDk.js";
 import { n as mergeCodexPreToolUse, t as HOOK_TOOLS } from "./hook-tools-UX2fmt81.js";
 import fs from "node:fs";
+import path from "node:path";
 //#region session/adapters/claude-code.ts
 var ID$1 = "claude-code";
 var COMMAND_NAME$1 = "claude";
@@ -183,9 +186,15 @@ function launchSessionId({ resumeSessionId, extraArgs, generatedId }) {
 		]
 	};
 }
-function buildArgs$1({ dangerouslySkipPermissions = false, resumeSessionId = null, extraArgs = [], initialPrompt = null } = {}) {
+var APPEND_SYSTEM_PROMPT_FLAG = "--append-system-prompt";
+var APPENDED_SYSTEM_PROMPT_FLAGS = Object.freeze([APPEND_SYSTEM_PROMPT_FLAG, "--append-system-prompt-file"]);
+function isAppendedSystemPromptArgument(launchArgument) {
+	return APPENDED_SYSTEM_PROMPT_FLAGS.some((flag) => launchArgument === flag || launchArgument.startsWith(`${flag}=`));
+}
+function buildArgs$1({ dangerouslySkipPermissions = false, resumeSessionId = null, extraArgs = [], initialPrompt = null, hasOuterSandbox = false, canRunHelpCommand = true } = {}) {
 	const args = dangerouslySkipPermissions ? ["--dangerously-skip-permissions"] : [];
 	if (resumeSessionId) args.push("--resume", resumeSessionId);
+	if (canRunHelpCommand && !extraArgs.some(isAppendedSystemPromptArgument)) args.push(APPEND_SYSTEM_PROMPT_FLAG, supervisionLine({ isSandboxed: hasOuterSandbox }));
 	for (let index = 0; index < extraArgs.length; index += 1) {
 		const argument = extraArgs[index];
 		if (resumeSessionId && argument === "--session-id") {
@@ -233,6 +242,190 @@ var claudeCode = {
 	mapHookPromptDetail
 };
 //#endregion
+//#region server/usage/core/usage-scan-core.ts
+function laneSpendStatus({ isTrackingEnabled, scan }) {
+	if (!isTrackingEnabled) return "tracking-off";
+	if (scan === null) return "scanner-missing";
+	if (scan.lastOutcome === "io-failed") return "read-failing";
+	if (!scan.isHistoryCaughtUp || scan.lastOutcome === null) return "catching-up";
+	return "known";
+}
+function decideFileRead(prior, stat) {
+	if (!prior) return {
+		action: "restart",
+		readFrom: 0
+	};
+	if (!stat || typeof stat.size !== "number") return {
+		action: "skip",
+		readFrom: prior.offset || 0
+	};
+	if (stat.size < (prior.size || 0)) return {
+		action: "restart",
+		readFrom: 0
+	};
+	if (stat.size < (prior.offset || 0)) return {
+		action: "restart",
+		readFrom: 0
+	};
+	if (stat.size === (prior.offset || 0) && stat.mtimeMs === prior.mtimeMs) return {
+		action: "skip",
+		readFrom: prior.offset || 0
+	};
+	return {
+		action: "append",
+		readFrom: prior.offset || 0
+	};
+}
+function splitLines(carry, chunkText) {
+	const text = `${carry || ""}${chunkText || ""}`;
+	const lines = text.split(/\r?\n/);
+	const nextCarry = text.endsWith("\n") || text.endsWith("\r\n") ? "" : lines.pop();
+	return {
+		lines: lines.filter((line) => line.length > 0),
+		carry: nextCarry || ""
+	};
+}
+function resolveProjectsDirs(env = process.env, extraDirs = [], isDirectory, homeDir = null) {
+	if (typeof isDirectory !== "function") throw new TypeError("resolveProjectsDirs requires an isDirectory function");
+	const surviving = projectDirCandidates(env, extraDirs, homeDir).filter(isDirectory);
+	if (!configDirOverride(env)) return surviving;
+	if (projectDirCandidates(env, [], homeDir).filter(isDirectory).length === 0) throw new Error("CLAUDE_CONFIG_DIR is set but no projects directory exists");
+	return surviving;
+}
+function projectDirCandidates(env = process.env, extraDirs = [], homeDir = null) {
+	const override = configDirOverride(env);
+	const extraHomes = normalizeHomeCandidates(extraDirs, env, homeDir);
+	if (override) return uniqueStrings([...projectsDirsFromHomes(normalizeHomeCandidates(override.split(","), env, homeDir)), ...projectsDirsFromHomes(extraHomes)]);
+	const resolvedHomeDir = resolveHomeDir(env, homeDir);
+	if (!resolvedHomeDir) return uniqueStrings(projectsDirsFromHomes(extraHomes));
+	const xdgConfigHome = rawTextOr(env.XDG_CONFIG_HOME, null) || path.join(resolvedHomeDir, ".config");
+	return uniqueStrings([...projectsDirsFromHomes([path.join(xdgConfigHome, "claude"), path.join(resolvedHomeDir, ".claude")]), ...projectsDirsFromHomes(extraHomes)]);
+}
+function configDirOverride(env) {
+	return (typeof env.CLAUDE_CONFIG_DIR === "string" ? env.CLAUDE_CONFIG_DIR : "").trim();
+}
+function projectsDirsFromHomes(homes) {
+	const projectsDirs = [];
+	for (const candidate of homes) {
+		const home = path.basename(candidate) === "projects" ? path.dirname(candidate) : candidate;
+		const projectsDir = path.join(home, "projects");
+		projectsDirs.push(projectsDir);
+	}
+	return projectsDirs;
+}
+function normalizeHomeCandidates(candidates, env, homeDir) {
+	if (!Array.isArray(candidates)) return [];
+	return candidates.map((candidate) => expandTilde(String(candidate || "").trim(), env, homeDir)).filter(Boolean);
+}
+function expandTilde(candidate, env, homeDir) {
+	if (!candidate.startsWith("~")) return candidate;
+	const home = resolveHomeDir(env, homeDir);
+	if (!home) return "";
+	if (candidate === "~") return home;
+	if (!candidate.startsWith(`~${path.sep}`) && !candidate.startsWith("~/")) return candidate;
+	return path.join(home, candidate.slice(2));
+}
+function resolveHomeDir(env, homeDir) {
+	return rawTextOr(env.HOME, null) || rawTextOr(env.USERPROFILE, null) || homeDir;
+}
+function uniqueStrings(values) {
+	return Array.from(new Set(values));
+}
+function passOutcome({ byteLimited, ioFailures }) {
+	if (ioFailures > 0) return "io-failed";
+	if (byteLimited) return "byte-limited";
+	return "complete";
+}
+function shouldPersistWarehouse({ outcome, storeReset }) {
+	if (outcome === "complete") return true;
+	if (outcome === "byte-limited") return false;
+	return !storeReset;
+}
+function continuationDelayMs({ outcome, ioFailureStreak, partialMs }) {
+	if (outcome === "complete") return null;
+	if (outcome === "byte-limited") return partialMs;
+	return nextBackoffMs({
+		attempt: ioFailureStreak,
+		baseMs: 3e4,
+		maxMs: 3e5
+	});
+}
+function shouldEvaluateDespiteIoFailures({ ioFailureStreak, limit }) {
+	if (!Number.isFinite(ioFailureStreak) || !Number.isFinite(limit)) return false;
+	if (limit <= 0) return false;
+	return ioFailureStreak >= limit;
+}
+function vendorHomes(env, varName, defaultDirName, homeDir) {
+	const rawOverride = env?.[varName];
+	const override = typeof rawOverride === "string" ? rawOverride.trim() : "";
+	if (override) return normalizeHomeCandidates(override.split(","), env, homeDir);
+	const home = resolveHomeDir(env, homeDir);
+	if (!home) return [];
+	return [path.join(home, defaultDirName)];
+}
+function codexHomes(env = process.env, homeDir = null) {
+	return vendorHomes(env, "CODEX_HOME", ".codex", homeDir);
+}
+function grokHomes(env = process.env, homeDir = null) {
+	return vendorHomes(env, "GROK_HOME", ".grok", homeDir);
+}
+function codexRootCandidates(homes) {
+	const candidates = [];
+	for (const home of homes) {
+		candidates.push({
+			dir: path.join(home, "sessions"),
+			kind: "active",
+			home
+		});
+		candidates.push({
+			dir: path.join(home, "archived_sessions"),
+			kind: "archived",
+			home
+		});
+	}
+	return candidates;
+}
+function codexFallbackRoots(homes, survivingRoots) {
+	const covered = new Set(survivingRoots.map((root) => root.home));
+	return homes.filter((home) => !covered.has(home)).map((home) => ({
+		dir: home,
+		kind: "flat",
+		home
+	}));
+}
+function grokRootCandidates(homes) {
+	return homes.map((home) => ({
+		dir: path.join(home, "sessions"),
+		kind: "active",
+		home
+	}));
+}
+var GROK_USAGE_FILENAME = "updates.jsonl";
+function isUsageFile(vendor, fileName) {
+	if (typeof fileName !== "string") return false;
+	if (vendor === "grok") return fileName === GROK_USAGE_FILENAME;
+	return fileName.endsWith(".jsonl");
+}
+function dedupeCodexFiles(files) {
+	const byName = /* @__PURE__ */ new Map();
+	for (const file of files) {
+		const name = path.basename(file.file);
+		const existing = byName.get(name);
+		if (!existing) {
+			byName.set(name, file);
+			continue;
+		}
+		if (existing.kind === "archived" && file.kind !== "archived") byName.set(name, file);
+	}
+	return Array.from(byName.values());
+}
+function codexSessionIdFromPath(filePath) {
+	const base = path.basename(String(filePath || ""), ".jsonl");
+	const match = /([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$/.exec(base);
+	if (match) return match[1];
+	return base || null;
+}
+//#endregion
 //#region session/adapters/codex.ts
 var ID = "codex";
 var COMMAND_NAME = "codex";
@@ -371,8 +564,23 @@ function permissionArgs(dangerouslySkipPermissions, hasOuterSandbox) {
 	if (dangerouslySkipPermissions) return SKIP_PERMISSIONS_ARGS;
 	return [];
 }
-function buildArgs({ dangerouslySkipPermissions = false, resumeSessionId = null, extraArgs = [], initialPrompt = null, hasOuterSandbox = false } = {}) {
+var OPERATOR_CONFIG_FILE_NAME = "config.toml";
+var DEVELOPER_INSTRUCTIONS_KEY = "developer_instructions";
+var DEVELOPER_INSTRUCTIONS_DECLARATION_RE = /^[^\S\r\n]*["']?developer_instructions["']?[^\S\r\n]*=/m;
+function operatorConfigPath(env) {
+	const [codexHome] = codexHomes(env, null);
+	if (!codexHome) return null;
+	return path.join(codexHome, OPERATOR_CONFIG_FILE_NAME);
+}
+function setsOperatorInstructions(operatorConfigText) {
+	return DEVELOPER_INSTRUCTIONS_DECLARATION_RE.test(operatorConfigText);
+}
+function isDeveloperInstructionsOverride(launchArgument) {
+	return launchArgument.startsWith(`${DEVELOPER_INSTRUCTIONS_KEY}=`);
+}
+function buildArgs({ dangerouslySkipPermissions = false, resumeSessionId = null, extraArgs = [], initialPrompt = null, hasOuterSandbox = false, hasOperatorInstructions = false, canRunHelpCommand = true } = {}) {
 	const args = [...UPDATE_CHECK_ARGS];
+	if (canRunHelpCommand && !hasOperatorInstructions && !extraArgs.some(isDeveloperInstructionsOverride)) args.push("-c", `${DEVELOPER_INSTRUCTIONS_KEY}='''${supervisionLine({ isSandboxed: hasOuterSandbox })}'''`);
 	if (resumeSessionId) args.push("resume", resumeSessionId);
 	args.push(...permissionArgs(dangerouslySkipPermissions, hasOuterSandbox));
 	if (extraArgs.length > 0) args.push(...extraArgs);
@@ -391,6 +599,8 @@ var codex = {
 	buildSpawnCommand,
 	buildEnv,
 	buildArgs,
+	operatorConfigPath,
+	setsOperatorInstructions,
 	buildHookArgs,
 	buildHookCommand,
 	mayContributeHooks,
@@ -597,4 +807,4 @@ function cachedAgentResolvability(agentId) {
 	};
 }
 //#endregion
-export { describeAgentResolvability as a, isKnownAgentId as c, setCustomAgents as d, claudeCode as f, customAgentFingerprint as i, listAgentIds as l, cachedAgentResolvability as n, getAdapter as o, commandFor as r, hookProfileOf as s, DEFAULT_AGENT_ID as t, resolveAdapter as u };
+export { claudeCode as A, laneSpendStatus as C, shouldEvaluateDespiteIoFailures as D, resolveProjectsDirs as E, shouldPersistWarehouse as O, isUsageFile as S, projectDirCandidates as T, decideFileRead as _, describeAgentResolvability as a, grokHomes as b, isKnownAgentId as c, setCustomAgents as d, codexFallbackRoots as f, continuationDelayMs as g, codexSessionIdFromPath as h, customAgentFingerprint as i, splitLines as k, listAgentIds as l, codexRootCandidates as m, cachedAgentResolvability as n, getAdapter as o, codexHomes as p, commandFor as r, hookProfileOf as s, DEFAULT_AGENT_ID as t, resolveAdapter as u, dedupeCodexFiles as v, passOutcome as w, grokRootCandidates as x, expandTilde as y };

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

@@ -0,0 +1 @@
+export { n as runAgentApiCli, r as sessionLimitsHelpLines } from "./agent-api-cli-vGwstJ1j.js";

package/dist/chunks/{agent-api-cli-DuT7437B.js → agent-api-cli-vGwstJ1j.js}

@@ -1,12 +1,16 @@
 import { t as errorCode } from "./text-DoirglWV.js";
-import { a as AgentDispatchRequest, c as AgentTicketRequest, n as AGENT_URL_ENV } from "./session-C7rstCmA.js";
+import { a as AgentDispatchRequest, l as AgentTicketRequest, n as AGENT_URL_ENV, s as AgentLimitsReply } from "./session-D6xXN0UU.js";
 import { i as resolveHookTarget } from "./hook-relay-core-DA_bz2KA.js";
 import { n as decideSandboxProxy } from "./sandbox-proxy-core-hnQgKR0T.js";
-import { c as isAgentApiVerb, l as isOrchestratorAgentVerb } from "./agent-api-core-Ddg15j2j.js";
+import { t as parseJsonOrNull } from "./json-core-dfa_7Fak.js";
+import { a as formatSessionLimits } from "./session-routes-BYy3am9m.js";
+import { d as isOrchestratorAgentVerb, u as isAgentApiVerb } from "./agent-api-core-D1233u1U.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 ticketBody(rest) {
 	const parsed = AgentTicketRequest.safeParse({ workId: rest[0] });
 	return parsed.success ? parsed.data : null;
@@ -26,6 +30,7 @@ var BODY_BUILDERS = {
 		const docPath = rest.join(" ").trim();
 		return docPath ? { path: path.resolve(docPath) } : null;
 	},
+	limits: () => ({}),
 	dispatch: (rest) => {
 		const parsed = AgentDispatchRequest.safeParse(rest[0] === "--ready" ? { readyIntent: rest[1] } : { workId: rest[0] });
 		return parsed.success ? parsed.data : null;
@@ -41,6 +46,15 @@ function bodySaysOk(text) {
 		return false;
 	}
 }
+function limitsLines(replyText) {
+	const limits = AgentLimitsReply.safeParse(parseJsonOrNull(replyText));
+	if (!limits.success) return null;
+	return formatSessionLimits(limits.data);
+}
+function printableReply(verb, replyText) {
+	if (verb !== "limits") return replyText;
+	return limitsLines(replyText)?.join("\n") ?? replyText;
+}
 function verbEndpoint(rawUrl, verb) {
 	const target = resolveHookTarget(rawUrl, verb, AGENT_PATH_PREFIX);
 	if (!target.url) return { ok: false };
@@ -53,18 +67,19 @@ function verbEndpoint(rawUrl, verb) {
 		token
 	};
 }
-async function postDirectly(endpoint, headers, bodyText) {
+async function postDirectly({ endpoint, headers, bodyText, deadline }) {
 	const response = await fetch(endpoint, {
 		method: "POST",
 		headers,
-		body: bodyText
+		body: bodyText,
+		signal: deadline
 	});
 	return {
 		hasSuccessStatus: response.ok,
 		text: await response.text()
 	};
 }
-function postThroughSandboxProxy(sandboxProxy, endpoint, headers, bodyText) {
+function postThroughSandboxProxy(sandboxProxy, { endpoint, headers, bodyText, deadline }) {
 	const proxyHeaders = sandboxProxy.authorization ? { "proxy-authorization": sandboxProxy.authorization } : {};
 	return new Promise((resolve, reject) => {
 		const request = http.request({
@@ -77,7 +92,8 @@ function postThroughSandboxProxy(sandboxProxy, endpoint, headers, bodyText) {
 				...proxyHeaders,
 				host: endpoint.host,
 				"content-length": String(Buffer.byteLength(bodyText))
-			}
+			},
+			...deadline ? { signal: deadline } : {}
 		}, (response) => {
 			const chunks = [];
 			response.on("data", (chunk) => {
@@ -99,19 +115,39 @@ function postThroughSandboxProxy(sandboxProxy, endpoint, headers, bodyText) {
 function wasConnectionRefused(error) {
 	return errorCode(error?.cause) === "ECONNREFUSED";
 }
-async function postToAgentIngress(endpoint, token, body) {
-	const headers = {
-		"content-type": "application/json",
-		authorization: `Bearer ${token}`
+async function postToAgentIngress({ endpoint, token, body, deadline = null }) {
+	const post = {
+		endpoint,
+		headers: {
+			"content-type": "application/json",
+			authorization: `Bearer ${token}`
+		},
+		bodyText: JSON.stringify(body),
+		deadline
 	};
-	const bodyText = JSON.stringify(body);
 	try {
-		return await postDirectly(endpoint, headers, bodyText);
+		return await postDirectly(post);
 	} catch (error) {
 		if (!wasConnectionRefused(error)) throw error;
 		const sandboxProxy = decideSandboxProxy(process.env);
 		if (!sandboxProxy) throw error;
-		return postThroughSandboxProxy(sandboxProxy, endpoint, headers, bodyText);
+		return postThroughSandboxProxy(sandboxProxy, post);
+	}
+}
+async function sessionLimitsHelpLines({ timeoutMs = HELP_LIMITS_TIMEOUT_MS } = {}) {
+	const rawUrl = process.env[AGENT_URL_ENV];
+	if (!rawUrl) return [];
+	const target = verbEndpoint(rawUrl, "limits");
+	if (!target.ok) return [HELP_LIMITS_UNKNOWN_LINE];
+	try {
+		return limitsLines((await postToAgentIngress({
+			endpoint: target.endpoint,
+			token: target.token,
+			body: {},
+			deadline: AbortSignal.timeout(timeoutMs)
+		})).text) ?? [HELP_LIMITS_UNKNOWN_LINE];
+	} catch {
+		return [HELP_LIMITS_UNKNOWN_LINE];
 	}
 }
 async function runAgentApiCli(args) {
@@ -135,7 +171,7 @@ async function runAgentApiCli(args) {
 	}
 	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 with the agent API turned on`);
+		console.error(`glimmervoid: ${AGENT_URL_ENV} is not set, so this is not a Glimmervoid session`);
 		return 1;
 	}
 	const target = verbEndpoint(rawUrl, verb);
@@ -143,9 +179,13 @@ async function runAgentApiCli(args) {
 		console.error(`glimmervoid: ${AGENT_URL_ENV} must be a loopback http url under ${AGENT_PATH_PREFIX}, so nothing was sent`);
 		return 1;
 	}
-	const reply = await postToAgentIngress(target.endpoint, target.token, body);
-	console.log(reply.text);
+	const reply = await postToAgentIngress({
+		endpoint: target.endpoint,
+		token: target.token,
+		body
+	});
+	console.log(printableReply(verb, reply.text));
 	return reply.hasSuccessStatus && bodySaysOk(reply.text) ? 0 : 1;
 }
 //#endregion
-export { runAgentApiCli as n, postToAgentIngress as t };
+export { runAgentApiCli as n, sessionLimitsHelpLines as r, postToAgentIngress as t };

package/dist/chunks/{agent-api-core-Ddg15j2j.js → agent-api-core-D1233u1U.js}

@@ -1,14 +1,13 @@
-import { a as AgentDispatchRequest, i as AgentAttentionRequest, l as ORCHESTRATOR_AGENT_VERBS, o as AgentEditRequest, s as AgentSpawnRequest, t as AGENT_API_VERBS } from "./session-C7rstCmA.js";
+import { a as AgentDispatchRequest, c as AgentSpawnRequest, i as AgentAttentionRequest, o as AgentEditRequest, t as AGENT_API_VERBS, u as ORCHESTRATOR_AGENT_VERBS } from "./session-D6xXN0UU.js";
+import { c as spawnRoute, i as editRoute, n as attentionRoute, s as pushRoute, t as NO_OWN_WORKTREE_REASON } from "./session-routes-BYy3am9m.js";
 import crypto from "node:crypto";
 var MAX_SPAWNS_IN_FLIGHT = 1;
 var SPAWNABLE_DEPTH = 0;
 var REFUSAL_REASON = "unknown session";
 var INVALID_BODY_STATUS = 400;
 var PUSH_REFUSED_STATUS = 409;
-var PUSH_UNAVAILABLE_REASON = "not-operator-session";
 var PUSH_REFUSAL_COPY = Object.freeze({
-	[PUSH_UNAVAILABLE_REASON]: () => "only an operator session or a session it spawned can push",
-	"no-worktree": () => "this session has no worktree of its own, so there is nothing of its own to land",
+	"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",
@@ -40,12 +39,21 @@ function decideAgentRequest({ sessionId, presentedToken, expectedToken, isLoopba
 	if (!tokensMatch(presentedToken, expectedToken)) return refused();
 	return { ok: true };
 }
-function decideSpawnAllowance({ liveChildren, lifetimeSpawns, inFlight, depth }) {
-	if (depth !== SPAWNABLE_DEPTH) return {
+function refuseByRole(route) {
+	if (route.answers) return { ok: true };
+	return {
 		ok: false,
 		status: 403,
-		reason: "a spawned session may not spawn another"
+		reason: route.reason
 	};
+}
+function decideSpawnAllowance({ liveChildren, lifetimeSpawns, inFlight, depth, isFactoryWorker, isEphemeral }) {
+	const role = refuseByRole(spawnRoute({
+		isEphemeral,
+		isSpawnedChild: depth !== SPAWNABLE_DEPTH,
+		factoryRole: isFactoryWorker ? "worker" : null
+	}));
+	if (!role.ok) return role;
 	if (inFlight >= MAX_SPAWNS_IN_FLIGHT) return {
 		ok: false,
 		status: 429,
@@ -63,6 +71,24 @@ function decideSpawnAllowance({ liveChildren, lifetimeSpawns, inFlight, depth })
 	};
 	return { ok: true };
 }
+function decideAttentionAllowance(caller) {
+	return refuseByRole(attentionRoute(caller));
+}
+function decideEditAllowance(caller) {
+	return refuseByRole(editRoute(caller));
+}
+function describePushRouteRefusal(caller) {
+	const route = pushRoute(caller);
+	if (route.answers) return null;
+	return {
+		status: PUSH_REFUSED_STATUS,
+		body: {
+			ok: false,
+			reason: route.code,
+			error: route.reason
+		}
+	};
+}
 function isAgentApiVerb(verb) {
 	return AGENT_API_VERBS.includes(verb);
 }
@@ -125,7 +151,7 @@ function parseAgentVerb(verb, payload) {
 		status: 403,
 		error: `${verb} requires a live factory orchestrator`
 	};
-	if (verb === "board" || verb === "push") return {
+	if (verb === "board" || verb === "push" || verb === "limits") return {
 		ok: true,
 		verb
 	};
@@ -198,4 +224,4 @@ function deriveChildSessionName(parentName, existingNames) {
 	return candidate;
 }
 //#endregion
-export { decideTicketAction as a, isAgentApiVerb as c, decideSpawnAllowance as i, isOrchestratorAgentVerb as l, REFUSAL_REASON as n, deriveChildSessionName as o, decideAgentRequest as r, describePushLanding as s, PUSH_UNAVAILABLE_REASON as t, parseAgentVerb as u };
+export { decideSpawnAllowance as a, describePushLanding as c, isOrchestratorAgentVerb as d, parseAgentVerb as f, decideEditAllowance as i, describePushRouteRefusal as l, decideAgentRequest as n, decideTicketAction as o, decideAttentionAllowance as r, deriveChildSessionName as s, REFUSAL_REASON as t, isAgentApiVerb as u };

package/dist/chunks/{agent-setup-cli-CFielF2o.js → agent-setup-cli-BTAFcckd.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-BYKnBgdr.js";
-import { p as writeTextAtomicSync } from "./json-file-oEH9vt-0.js";
+import { a as classifyGrokHooksFile, o as renderGrokHooksFile, t as grok } from "./grok-KKgdSe-7.js";
+import { p as writeTextAtomicSync } from "./json-file-BaxGcB2R.js";
 import fs from "node:fs";
 import path from "node:path";
 //#region server/agent-setup-cli.ts

package/dist/chunks/child-process-safe-ChRmWAJP.js

@@ -0,0 +1 @@
+export { r as execFileSync } from "./child-process-safe-CbQnyh7D.js";