@parity-app/cli 0.1.0 → 0.3.0

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Andrew Craswell
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/dist/client-DsTLQ2lT.mjs

@@ -1,286 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { join } from "node:path";
-import { randomUUID } from "node:crypto";
-import { homedir } from "node:os";
-// src/caller.ts
-/** Who is driving Parity, named the way people know it, for the agent's cursor on the canvas. */
-/** Known clients, by the name they give MCP's `initialize`, most specific first. */
-const clients = [
-	[/claude[-_ ]?code/i, "Claude Code"],
-	[/^claude/i, "Claude"],
-	[/cursor/i, "Cursor"],
-	[/codex/i, "Codex"],
-	[/gemini/i, "Gemini CLI"],
-	[/windsurf|codeium/i, "Windsurf"],
-	[/copilot|visual studio code|^vscode/i, "Copilot"],
-	[/zed/i, "Zed"],
-	[/cline/i, "Cline"],
-	[/goose/i, "Goose"]
-];
-/**
-* An MCP client's name for people: a known agent's own name, else the title it gives, else its name with its
-* separators made spaces and its words capitalized ("my-agent" becomes "My Agent").
-*/
-function mcpCallerName(clientInfo) {
-	const name = typeof clientInfo?.name === "string" ? clientInfo.name.trim() : "";
-	const title = typeof clientInfo?.title === "string" ? clientInfo.title.trim() : "";
-	for (const [pattern, known] of clients) if (pattern.test(name) || pattern.test(title)) return known;
-	if (title) return title;
-	if (!name) return void 0;
-	return name.replace(/[-_]+(mcp[-_]?)?client$/i, "").split(/[-_\s]+/).filter(Boolean).map((word) => word[0].toUpperCase() + word.slice(1)).join(" ");
-}
-/**
-* Who runs the CLI, from what agents put in their shell's environment. `PARITY_AGENT_NAME` names it outright; with
-* no sign of an agent, it's someone at a terminal.
-*/
-function cliCallerName(env) {
-	const named = env.PARITY_AGENT_NAME?.trim();
-	if (named) return named;
-	if (env.CLAUDECODE === "1") return "Claude Code";
-	if (env.GEMINI_CLI === "1") return "Gemini CLI";
-	if (Object.keys(env).some((key) => key.startsWith("CODEX_"))) return "Codex";
-	return "Terminal";
-}
-// src/client.ts
-/** Where the running app writes its address and token. */
-const agentFile = process.env.PARITY_AGENT_FILE ?? join(homedir(), ".parity", "agent.json");
-let caller = cliCallerName(process.env);
-/** Tells callers with the same name apart. A terminal's calls are separate processes, so they share their name. */
-let callerId = process.env.PARITY_AGENT_ID?.trim() || caller;
-/**
-* Names who's calling in later calls, so the canvas can say who's at work. The MCP server learns the name from its
-* client, and is one session: its calls share an id, apart from any other session of the same agent.
-*/
-function setCaller(name, session = false) {
-	caller = name ?? caller;
-	callerId = session ? `${caller}#${randomUUID().slice(0, 8)}` : caller;
-}
-/** Calls the running Parity app. Fails with a clear message when it isn't running. */
-async function call(method, params = {}) {
-	let connection;
-	try {
-		connection = JSON.parse(await readFile(agentFile, "utf8"));
-	} catch {
-		throw new Error(`Parity isn't running (no ${agentFile}). Start the app, then try again.`);
-	}
-	let response;
-	try {
-		response = await fetch(`${connection.url}/rpc`, {
-			method: "POST",
-			headers: {
-				"content-type": "application/json",
-				authorization: `Bearer ${connection.token}`
-			},
-			body: JSON.stringify({
-				method,
-				params,
-				agent: caller,
-				agentId: callerId
-			})
-		});
-	} catch {
-		throw new Error(`Parity isn't answering at ${connection.url}. Is the app still running?`);
-	}
-	const body = await response.json();
-	if (body.error !== void 0) throw new Error(body.error);
-	return body.result;
-}
-/** A readable account of an exec call, for terminals and for agents. */
-function describeExec(result) {
-	const lines = [];
-	if (result.ok) lines.push(result.applied ? "Done. The changes are on the canvas as one undoable step." : "Done. Nothing changed.");
-	else {
-		lines.push(`Failed, nothing changed: ${result.error}`);
-		lines.push(`Fix it by retrying with editId "${result.editId}" and edits ({find, replace}) to the snippet.`);
-	}
-	if (result.output.length > 0) lines.push("", "Output:", ...result.output);
-	const created = Object.entries(result.created);
-	if (created.length > 0) lines.push("", "Created:", ...created.map(([name, id]) => `  ${name} = ${id}`));
-	if (result.warnings.length > 0) lines.push("", "Warnings (fix these next):", ...result.warnings.map((warning) => `  ${warning}`));
-	if (result.screenshots.length > 0) lines.push("", "Screenshots:", ...result.screenshots.map((shot) => `  ${shot.design} / ${shot.state} / ${shot.mode}: ${shot.path}`));
-	return lines.join("\n");
-}
-const impactOrder = [
-	"critical",
-	"serious",
-	"moderate",
-	"minor"
-];
-/**
-* A readable account of an accessibility check: each rule broken, worst first, with the layers that break it, the
-* frames they break it in and what's wrong. Alike layers, such as the rows of a list, share a line.
-*/
-function describeAccessibility(result) {
-	const { design, findings, frames } = result;
-	const checked = `${design.name} (${design.id}), ${frames === 1 ? "1 frame" : `${frames} frames`}`;
-	const rules = /* @__PURE__ */ new Map();
-	for (const finding of findings) rules.set(finding.rule, [...rules.get(finding.rule) ?? [], finding]);
-	const lines = [rules.size === 0 ? `No issues found in ${checked}, with axe-core against WCAG 2.2 AA.` : `${rules.size === 1 ? "1 rule" : `${rules.size} rules`} broken in ${checked}, with axe-core against WCAG 2.2 AA.`];
-	const groups = [...rules.values()].sort((a, b) => impactOrder.indexOf(a[0].impact) - impactOrder.indexOf(b[0].impact));
-	for (const group of groups) {
-		const { impact, rule, help, helpUrl } = group[0];
-		lines.push("", `${impact}: ${help} (${rule})`);
-		const byLayer = /* @__PURE__ */ new Map();
-		for (const finding of group) {
-			const key = `${finding.node ?? ""}\n${finding.detail}`;
-			const layer = byLayer.get(key) ?? {
-				name: finding.name ?? "The design",
-				nodes: finding.node ? [finding.node] : [],
-				detail: finding.detail,
-				frames: []
-			};
-			layer.frames.push({
-				state: finding.state,
-				mode: finding.mode
-			});
-			byLayer.set(key, layer);
-		}
-		const alike = /* @__PURE__ */ new Map();
-		for (const layer of byLayer.values()) {
-			const same = JSON.stringify([
-				layer.name,
-				layer.detail,
-				layer.frames
-			]);
-			const existing = alike.get(same);
-			if (existing) existing.nodes.push(...layer.nodes);
-			else alike.set(same, layer);
-		}
-		for (const layer of alike.values()) {
-			const where = layer.frames.length === frames && frames > 1 ? "every frame" : frameList(layer.frames);
-			const ids = layer.nodes.length > 0 ? ` (${layer.nodes.join(", ")})` : "";
-			lines.push(`  ${layer.name}${ids}, in ${where}: ${layer.detail}`);
-		}
-		lines.push(`  How to fix it: ${helpUrl}`);
-	}
-	if (result.warnings.length > 0) lines.push("", "Warnings:", ...result.warnings.map((warning) => `  ${warning}`));
-	lines.push("", "Automated checks find some issues, not all. Try the design with a keyboard and a screen reader too.");
-	return lines.join("\n");
-}
-/** A readable account of the layout problems in a design's frames, each once with the frames it's in. */
-function describeProblems(result) {
-	const { design, problems, frames } = result;
-	const checked = `${design.name} (${design.id}), ${frames === 1 ? "1 frame" : `${frames} frames`}`;
-	const grouped = /* @__PURE__ */ new Map();
-	for (const { problem, node, state, mode } of problems) {
-		const key = `${node ?? ""}\n${problem}`;
-		const entry = grouped.get(key) ?? {
-			problem,
-			...node ? { node } : {},
-			frames: []
-		};
-		entry.frames.push({
-			state,
-			mode
-		});
-		grouped.set(key, entry);
-	}
-	const count = grouped.size === 1 ? "1 problem" : `${grouped.size} problems`;
-	const lines = [grouped.size === 0 ? `No problems found in ${checked}.` : `${count} in ${checked}:`];
-	for (const { problem, node, frames: where } of grouped.values()) {
-		const every = where.length === frames && frames > 1 ? "every frame" : frameList(where);
-		lines.push(`  ${node ? `${node}: ` : ""}${problem}, in ${every}`);
-	}
-	if (result.warnings.length > 0) lines.push("", "Warnings:", ...result.warnings.map((warning) => `  ${warning}`));
-	return lines.join("\n");
-}
-/** Tokens by category, each with its value in every theme that sets one. */
-function describeTokens(tokens) {
-	if (tokens.length === 0) return "No tokens match.";
-	const lines = [`${tokens.length === 1 ? "1 token" : `${tokens.length} tokens`}. Name them in styles without "--".`];
-	const categories = /* @__PURE__ */ new Map();
-	for (const token of tokens) {
-		const key = `${token.category}, ${token.source}`;
-		categories.set(key, [...categories.get(key) ?? [], token]);
-	}
-	for (const [category, list] of categories) {
-		lines.push("", `${category}:`);
-		for (const token of list) {
-			const values = Object.entries(token.values).sort(([a], [b]) => first("default", a, b)).map(([theme, value]) => `${theme} ${value}`);
-			lines.push(`  ${token.name}: ${values.join(", ")}`);
-		}
-	}
-	return lines.join("\n");
-}
-/**
-* The project's own components, then each library's, then the icon libraries, then the exports left out and why, the
-* components failing to draw and why, and what the person corrected by hand.
-*/
-function describeComponents({ components, iconLibraries = [], leftOut = [], drawn = 0, failing = [], corrections = {} }) {
-	const groups = /* @__PURE__ */ new Map();
-	for (const component of components) {
-		const slash = component.indexOf("/");
-		const group = slash > 0 ? component.slice(0, slash) : "";
-		groups.set(group, [...groups.get(group) ?? [], slash > 0 ? component.slice(slash + 1) : component]);
-	}
-	const lines = [];
-	for (const [group, names] of [...groups].sort(([a], [b]) => first("", a, b))) lines.push(group ? `${group}, as ${group}/Name:` : "The project's own:", `  ${names.join(", ")}`, "");
-	if (iconLibraries.length > 0) lines.push(`Icons: ${iconLibraries.map((library) => `${library}, as ${library}/Name`).join("; ")}`, "");
-	if (leftOut.length > 0) {
-		lines.push("Not components:");
-		for (const entry of leftOut) lines.push(`  ${entry.name}, in ${entry.path}: ${entry.undecided ? "can't tell, " : ""}${entry.reason}`);
-		lines.push("");
-	}
-	if (failing.length > 0) {
-		lines.push(`Failing to draw on the canvas, ${failing.length} of ${failing.length + drawn} drawn so far:`);
-		for (const entry of failing) lines.push(`  ${entry.id}: ${entry.reason}`);
-		lines.push("");
-	}
-	const { include = [], exclude = [] } = corrections;
-	if (include.length > 0 || exclude.length > 0) {
-		const name = (ref) => ref.export === "default" ? "the default export" : ref.export;
-		lines.push("Corrected by hand in the project file:");
-		for (const ref of include) lines.push(`  listed: ${name(ref)}, in ${ref.path}`);
-		for (const ref of exclude) lines.push(`  taken off: ${name(ref)}, in ${ref.path}`);
-	}
-	return lines.join("\n").trimEnd();
-}
-/** A component's props, with each variant's options and default. */
-function describeProps(result) {
-	if (!result.known) return `${result.component}'s props haven't been read from its source yet. Try again in a moment.`;
-	const imported = result.import && result.import !== result.path ? `, imported from "${result.import}"` : "";
-	const lines = [`${result.component}, from ${result.path}${imported}:`];
-	for (const prop of result.props) {
-		const options = prop.options ? `: ${prop.options.map((option) => JSON.stringify(option)).join(", ")}` : "";
-		const fallback = prop.default === void 0 ? "" : `, default ${JSON.stringify(prop.default)}`;
-		lines.push(`  ${prop.name} (${prop.kind}${prop.required ? ", required" : ""})${options}${fallback}`);
-	}
-	if (result.props.length === 0) lines.push("  No props of its own. --all lists the attributes it passes on.");
-	return lines.join("\n");
-}
-/** Frames as state and mode ids, naming a mode once when they share it: "default, error in desktop-light". */
-function frameList(frames) {
-	const modes = [...new Set(frames.map((frame) => frame.mode))];
-	if (modes.length === 1) return `${frames.map((frame) => frame.state).join(", ")} in ${modes[0]}`;
-	return frames.map((frame) => `${frame.state} in ${frame.mode}`).join(", ");
-}
-/** A readable account of what a project's code wrote to the console, oldest first, with where each came from. */
-function describeConsole(result) {
-	const { tab, entries } = result;
-	if (entries.length === 0) return `${tab.name}'s code hasn't written anything to the console.`;
-	const lines = [`${entries.length === 1 ? "1 message" : `${entries.length} messages`} from ${tab.name}'s code, oldest first:`];
-	for (const entry of entries) {
-		const time = new Date(entry.last).toLocaleTimeString([], { hour12: false });
-		const repeats = entry.count > 1 ? ` (${entry.count} times)` : "";
-		const [first = "", ...rest] = entry.text.split("\n");
-		lines.push("", `${time} ${entry.level}${repeats}: ${first}`, ...rest.map((line) => `  ${line}`));
-		const offscreen = entry.where === "offscreen" ? ", in an offscreen render" : "";
-		lines.push(`  at ${scriptPath(entry.source)}:${entry.line}${offscreen}`);
-	}
-	return lines.join("\n");
-}
-/** Compares two names alphabetically, with `name` before every other. */
-function first(name, a, b) {
-	if (a === name) return -1;
-	if (b === name) return 1;
-	return a.localeCompare(b);
-}
-/** A script's path on its server, without the cache-busting query Vite adds. */
-function scriptPath(url) {
-	try {
-		return new URL(url).pathname;
-	} catch {
-		return url || "an unknown script";
-	}
-}
-export { describeConsole as a, describeProps as c, mcpCallerName as d, describeComponents as i, describeTokens as l, call as n, describeExec as o, describeAccessibility as r, describeProblems as s, agentFile as t, setCaller as u };