glimmervoid 0.38.2 → 0.40.0

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-DmMfCw5O.js → agent-setup-cli-CeBBwKuL.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-B6bsCgdd.js";
-import { p as writeTextAtomicSync } from "./json-file-CIJf0Cel.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";
 //#region server/agent-setup-cli.ts

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

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