@parity-app/cli 0.7.2 → 0.7.4

package/dist/bin.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { c as CodedError, d as errorDetails, f as readErrorDetails, i as jsonText, l as closest, s as plainObject, t as checkData, u as errorCodes } from "./schema-CemdtCeF.mjs";
-import { _ as requests, a as describeExec, c as describeProps, f as setCaller, g as requestJsonSchema, h as replies, i as describeConsole, l as describeStatus, m as readRequest, n as describeAccessibility, o as describeModes, p as mcpCallerName, r as describeComponents, s as describeProblems, t as call, u as describeTokens, v as skillRequest } from "./client-BtxrNeIk.mjs";
+import { _ as requests, a as describeExec, c as describeProps, f as setCaller, g as requestJsonSchema, h as replies, i as describeConsole, l as describeStatus, m as readRequest, n as describeAccessibility, o as describeModes, p as mcpCallerName, r as describeComponents, s as describeProblems, t as call, u as describeTokens, v as skillRequest } from "./client-D6bpjpy-.mjs";
 import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
 import { dirname, join, normalize, relative, resolve, sep } from "node:path";
 import { parseArgs } from "node:util";
@@ -144,7 +144,7 @@ const executeOperation = {
 	/** Discovery uses the same contract, with just the two historical MCP field aliases. */
 	inputSchema: discoverySchema,
 	async run(input, send) {
-		return execResponse(await send("exec", executeRequest(input), "tab", replies.exec));
+		return execResponse(await send("exec", executeRequest(input), "tab"));
 	}
 };
 // src/check.ts
@@ -160,8 +160,8 @@ const appErrorsFile = jsonText(z.record(z.string(), z.string()));
 */
 async function runCheck(library, options) {
 	if (!library) throw new Error("parity lib check <library> [--tab t] [--mode m]");
-	const { componentNode, generateId, librarySource, withLibraryContext } = await import("./src-tY0sf-AQ.mjs");
-	const { newestEntries, registryDir } = await import("./src-Chy2scQg.mjs");
+	const { componentNode, generateId, librarySource, withLibraryContext } = await import("./src-Btr2eWdT.mjs");
+	const { newestEntries, registryDir } = await import("./src-Q382DbAK.mjs");
 	const entry = (await newestEntries()).find((item) => item.manifest.id === library);
 	if (!entry) throw new Error(`The registry has no library "${library}"`);
 	const list = entry.manifest.components?.list ?? {};
@@ -295,8 +295,8 @@ function describeCheck(report) {
 * because it reads the project's files and its own copy of TypeScript.
 */
 async function runLib(packageName, options) {
-	const { appManifestPath, generateLibrary, manifestText, mergeManifest, reviseLibrary } = await import("./src-CPka3fhs.mjs");
-	const { covers, registryDir, registryEntries } = await import("./src-Chy2scQg.mjs");
+	const { appManifestPath, generateLibrary, manifestText, mergeManifest, reviseLibrary } = await import("./src-Bf12xdm5.mjs");
+	const { covers, registryDir, registryEntries } = await import("./src-Q382DbAK.mjs");
 	const spec = packageName === void 0 ? void 0 : packageSpec(packageName);
 	let root = resolve(options.root ?? ".");
 	if (spec && (spec.version !== void 0 || options.registry && !options.root)) {
@@ -307,7 +307,7 @@ async function runLib(packageName, options) {
 		console.error(`Installing ${spec.name} ${version} on its own…`);
 		root = await installedVersion(spec.name, version);
 	}
-	const { parseLibraryEdits } = await import("./src-CPka3fhs.mjs");
+	const { parseLibraryEdits } = await import("./src-Bf12xdm5.mjs");
 	const trialEdits = options.edits ? parseLibraryEdits(JSON.parse(await readFile(resolve(options.edits), "utf8"))) : void 0;
 	const recordedId = options.registry && spec ? options.id ?? (await registryEntries()).find((entry) => entry.manifest.package?.name === spec.name)?.manifest.id : void 0;
 	const appErrors = recordedId ? await readAppErrors(registryDir(), recordedId) : void 0;
@@ -470,7 +470,8 @@ function describeReport(report) {
 * An operation whose canonical result is built from the app's checked answer, given the checked request. A request's
 * error points at the field, since an operation's fields are flat.
 */
-function mapped(method, input, reply, result, options = {}) {
+function mapped(method, result, options = {}) {
+	const input = requests[method];
 	const fields = Object.keys(input.shape);
 	const routing = routingFor(fields);
 	return {
@@ -479,7 +480,7 @@ function mapped(method, input, reply, result, options = {}) {
 		routing,
 		async run(given, send) {
 			const request = readRequest(input, given, 1);
-			return result(await send(method, request, routing, reply), request);
+			return result(await send(method, request, routing), request);
 		},
 		failed: options.failed ?? (() => false),
 		structured: options.structured ?? ((value) => Object.fromEntries(Object.entries(value)))
@@ -492,8 +493,8 @@ function routingFor(fields) {
 	return "copies";
 }
 /** An operation whose canonical result is the app's answer. */
-function operation(method, input, reply, options = {}) {
-	return mapped(method, input, reply, (answer) => answer, options);
+function operation(method, options = {}) {
+	return mapped(method, (answer) => answer, options);
 }
 /** The first `count` items, with how many there were, so a reply says when it left some out. */
 function bounded(items, count, keep = "first") {
@@ -518,18 +519,18 @@ z.looseObject({
 	...truncation
 });
 const operations = {
-	tabs: mapped("tabs", requests.tabs, replies.tabs, (tabs) => ({ tabs })),
-	state: operation("state", requests.state, replies.state),
-	status: operation("status", requests.status, replies.status),
-	modes: operation("modes", requests.modes, replies.modes),
-	open: operation("open", requests.open, replies.open),
-	screenshot: mapped("screenshot", requests.screenshot, replies.screenshot, (reply) => execResponse(reply, Object.keys(requests.screenshot.shape)), {
+	tabs: mapped("tabs", (tabs) => ({ tabs })),
+	state: operation("state"),
+	status: operation("status"),
+	modes: operation("modes"),
+	open: operation("open"),
+	screenshot: mapped("screenshot", (reply) => execResponse(reply, Object.keys(requests.screenshot.shape)), {
 		failed: executionFailed,
 		structured: structuredExec
 	}),
-	problems: operation("problems", requests.problems, replies.problems, { failed: (result) => result.problems.length > 0 }),
-	accessibility: operation("accessibility", requests.accessibility, replies.accessibility, { failed: (result) => result.findings.length > 0 }),
-	console: mapped("console", requests.console, replies.console, ({ tab, entries }, request) => {
+	problems: operation("problems", { failed: (result) => result.problems.length > 0 }),
+	accessibility: operation("accessibility", { failed: (result) => result.findings.length > 0 }),
+	console: mapped("console", ({ tab, entries }, request) => {
 		const { items, total, truncated } = bounded(entries, request.limit, "last");
 		return {
 			tab,
@@ -538,7 +539,7 @@ const operations = {
 			truncated
 		};
 	}),
-	tokens: mapped("tokens", requests.tokens, replies.tokens, (tokens, request) => {
+	tokens: mapped("tokens", (tokens, request) => {
 		const { items, total, truncated } = bounded(tokens, request.limit);
 		return {
 			tokens: items,
@@ -546,8 +547,8 @@ const operations = {
 			truncated
 		};
 	}),
-	components: operation("components", requests.components, replies.components),
-	props: operation("props", requests.props, replies.props)
+	components: operation("components"),
+	props: operation("props")
 };
 const skillOperation = {
 	inputSchema: requestJsonSchema(skillRequest),

package/dist/{client-BtxrNeIk.mjs → client-D6bpjpy-.mjs}

@@ -886,9 +886,10 @@ function setCaller(name, session = false) {
 * in `@parity-app/agent/routing`, and returns its answer once `reply` has checked it. Fails with a clear message, and a
 * code, when no copy is running, none has the project, or the call fails: the app's own code when it gives one.
 */
-async function call(method, params, routing, reply) {
+async function call(method, given, routing) {
+	const params = given;
 	const copies = await runningCopies();
-	if (routing === "copies") return answer(reply, openTabs(copies), "tabs");
+	if (routing === "copies") return answer(replies[method], openTabs(copies), "tabs");
 	const target = route(copies, routing === "open" ? {
 		kind: "open",
 		root: String(params.root)
@@ -909,7 +910,7 @@ async function call(method, params, routing, reply) {
 	return send(target.copy.entry, method, target.tab ? {
 		...params,
 		tab: target.tab.id
-	} : params, reply);
+	} : params);
 }
 /** A folder's real path, through any link, or the folder as named when it can't be read. */
 function real(path) {
@@ -951,17 +952,18 @@ async function runningCopies() {
 /** What a copy has open and when it was last used; just its tabs from an app too old to say more. */
 async function reportOf(entry) {
 	try {
-		return await send(entry, "copy", {}, replies.copy, 5e3);
+		return await send(entry, "copy", {}, 5e3);
 	} catch (error) {
 		if (!(error instanceof CodedError) || error.details.code !== "app_error") return void 0;
 		try {
-			return { tabs: await send(entry, "tabs", {}, replies.tabs, 5e3) };
+			return { tabs: await send(entry, "tabs", {}, 5e3) };
 		} catch {
 			return;
 		}
 	}
 }
-async function send(entry, method, params, reply, timeout) {
+/** Asks one copy, and returns its answer once the method's schema in `contracts.ts` has checked it. */
+async function send(entry, method, params, timeout) {
 	let response;
 	try {
 		response = await fetch(`${entry.url}/rpc`, {
@@ -986,7 +988,7 @@ async function send(entry, method, params, reply, timeout) {
 	}
 	const body = answer(jsonText(rpcReply), await response.text(), method);
 	if (body.error !== void 0) throw new CodedError(body.error, readErrorDetails(body.details) ?? { code: "app_error" });
-	return answer(reply, body.result, method);
+	return answer(replies[method], body.result, method);
 }
 /** The app's answer to `method` once `schema` has checked it, or `app_error` saying what this CLI couldn't read. */
 function answer(schema, value, method) {

package/dist/index.d.mts

@@ -594,6 +594,16 @@ declare const replies: {
     }, z.core.$loose>>;
   }, z.core.$loose>;
 };
+/**
+ * Each RPC method's params, as the CLI sends them once its request schema has read them, and its answer (PAR-564). The
+ * CLI client asks by it and the app's dispatch answers by it, so a shape that drifts on either side fails to compile.
+ * `copy` takes nothing.
+ */
+type AgentMethods = { [M in keyof typeof replies]: {
+  params: M extends keyof typeof requests ? z.output<(typeof requests)[M]> : Record<string, never>;
+  result: z.output<(typeof replies)[M]>;
+}; };
+type AgentMethod = keyof AgentMethods;
 declare const tabsResult: z.ZodObject<{
   tabs: z.ZodArray<z.ZodObject<{
     id: z.ZodString;
@@ -788,7 +798,7 @@ export type Routing = "tab" | "open" | "copies";
  * in `@parity-app/agent/routing`, and returns its answer once `reply` has checked it. Fails with a clear message, and a
  * code, when no copy is running, none has the project, or the call fails: the app's own code when it gives one.
  */
-export declare function call<Reply extends z.ZodType>(method: string, params: Record<string, unknown>, routing: Routing, reply: Reply): Promise<z.output<Reply>>;
+export declare function call<M extends AgentMethod>(method: M, given: AgentMethods[M]["params"], routing: Routing): Promise<AgentMethods[M]["result"]>;
 /** A readable account of an exec call, for terminals and for agents. */
 export declare function describeExec(result: ExecResponse): string;
 /** Where a tab's edits stand: the revision, what's applied and undoable, what's on disk, and what failed to write. */

package/dist/index.mjs

@@ -1 +1 @@
-export { t as call, n as describeAccessibility, r as describeComponents, i as describeConsole, a as describeExec, o as describeModes, s as describeProblems, c as describeProps, l as describeStatus, u as describeTokens, d as registry, f as setCaller } from "./client-BtxrNeIk.mjs";
+export { t as call, n as describeAccessibility, r as describeComponents, i as describeConsole, a as describeExec, o as describeModes, s as describeProblems, c as describeProps, l as describeStatus, u as describeTokens, d as registry, f as setCaller } from "./client-D6bpjpy-.mjs";

package/dist/{src-CzZ9eIU8.mjs → src-B9VW36v9.mjs}

@@ -1,4 +1,4 @@
-import { d as libraryManifestExtension, m as parseLibraryManifest, o as applyLibraryEdits, p as parseLibraryEdits } from "./src-Csdxx4kB.mjs";
+import { d as libraryManifestExtension, m as parseLibraryManifest, o as applyLibraryEdits, p as parseLibraryEdits } from "./src-DjSCuWcT.mjs";
 import { createRequire } from "node:module";
 import { readFile, readdir } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";

package/dist/{src-CPka3fhs.mjs → src-Bf12xdm5.mjs}

@@ -1,6 +1,6 @@
 import { i as jsonText, o as parseData, r as finiteNumber, s as plainObject } from "./schema-CemdtCeF.mjs";
-import { D as collectCustomProperties, M as lengthToPixels, N as packageManifest, c as isMadeValue, d as libraryManifestExtension, h as renderSlotOf, l as isSampleElement, m as parseLibraryManifest, o as applyLibraryEdits, p as parseLibraryEdits, u as isSampleRender } from "./src-Csdxx4kB.mjs";
-import { r as readLibraryEdits, s as parseJsonc } from "./src-CzZ9eIU8.mjs";
+import { F as packageManifest, P as lengthToPixels, c as isMadeValue, d as libraryManifestExtension, h as renderSlotOf, k as collectCustomProperties, l as isSampleElement, m as parseLibraryManifest, o as applyLibraryEdits, p as parseLibraryEdits, u as isSampleRender } from "./src-DjSCuWcT.mjs";
+import { r as readLibraryEdits, s as parseJsonc } from "./src-B9VW36v9.mjs";
 import { a as publishedVersions, n as packageFile, o as repositoryFiles, r as publishedSource } from "./published-CdXoUgfD.mjs";
 import { createRequire } from "node:module";
 import { mkdir, readFile, readdir, realpath, rm, stat, writeFile } from "node:fs/promises";

package/dist/src-Btr2eWdT.mjs

@@ -0,0 +1,5 @@
+import "./schema-CemdtCeF.mjs";
+import "./client-D6bpjpy-.mjs";
+export { t as componentNode, D as generateId, n as librarySource, i as withLibraryContext } from "./src-DjSCuWcT.mjs";
+import "./src-B9VW36v9.mjs";
+import "./src-Bf12xdm5.mjs";

package/dist/{src-Csdxx4kB.mjs → src-DjSCuWcT.mjs}

@@ -733,6 +733,7 @@ function problem(context, path, message) {
 		path
 	});
 }
+/** A project file's schema, which the project service also checks a saved document with (PAR-565). */
 const canvasDocument = fileObject({
 	version: z.literal(3),
 	containers: z.array(containerSpec),
@@ -1467,4 +1468,4 @@ function sampleIds(sample, library) {
 		...sample.children ? { children: sample.children.map(child) } : {}
 	};
 }
-export { viewportWidthProperty as A, parseCanvasDocument as C, collectCustomProperties as D, modeSettings as E, lengthToPixels as M, packageManifest as N, remProperty as O, paramTypes as S, generateId as T, containerKinds as _, openProps as a, linkEndKinds as b, isMadeValue as c, libraryManifestExtension as d, parentSignals as f, canvasObjectKinds as g, renderSlotOf as h, withLibraryContext as i, deviceKinds as j, viewportHeightProperty as k, isSampleElement as l, parseLibraryManifest as m, librarySource as n, applyLibraryEdits as o, parseLibraryEdits as p, sampleIds as r, componentEvidence as s, componentNode as t, isSampleRender as u, imageFits as v, walkNodes as w, linkTypes as x, linkAllowed as y };
+export { remProperty as A, linkTypes as C, generateId as D, walkNodes as E, packageManifest as F, viewportWidthProperty as M, deviceKinds as N, modeSettings as O, lengthToPixels as P, linkEndKinds as S, parseCanvasDocument as T, canvasObjectKinds as _, openProps as a, imageFits as b, isMadeValue as c, libraryManifestExtension as d, parentSignals as f, canvasDocument as g, renderSlotOf as h, withLibraryContext as i, viewportHeightProperty as j, collectCustomProperties as k, isSampleElement as l, parseLibraryManifest as m, librarySource as n, applyLibraryEdits as o, parseLibraryEdits as p, sampleIds as r, componentEvidence as s, componentNode as t, isSampleRender as u, containerKinds as v, paramTypes as w, linkAllowed as x, detectionCorrections as y };

package/dist/{src-Chy2scQg.mjs → src-Q382DbAK.mjs}

@@ -1 +1 @@
-export { t as covers, n as newestEntries, i as registryDir, a as registryEntries } from "./src-CzZ9eIU8.mjs";
+export { t as covers, n as newestEntries, i as registryDir, a as registryEntries } from "./src-B9VW36v9.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parity-app/cli",
-  "version": "0.7.2",
+  "version": "0.7.4",
   "license": "MIT",
   "type": "module",
   "description": "Drive the Parity app from a terminal or an agent: read state, run edits, take screenshots, serve MCP.",

package/skills/execute.md

@@ -403,6 +403,20 @@ theme, or `SetTokens({ primary: { default: "…", dark: "…" } })` per theme. E
 saving writes them into the project's code, so do it only when the person asks to change the design system, not to style
 one design. They're undone with the call's other changes.
 
+`SetTokens` refuses a value the Tokens panel would refuse, throwing an `invalid_input` error that names the token and
+theme and says what's wrong: a bracket or quote left open, a `var()` naming no token, or a token built on itself. None
+of that call's values are kept. A value that isn't its token's kind (`"bluish"` for a color) is refused when the call
+ends, and then nothing in the call is applied.
+
+```js
+SetTokens({ primary: { default: "oklch(0.55 0.2 260)", dark: "var(--foreground)" } })
+try {
+  SetTokens({ primary: "oklch(0.55 0.2 260" })
+} catch (error) {
+  Print(error.message) // SetTokens/primary/default: A bracket isn't closed. Add ) at the end.
+}
+```
+
 ## Checking
 
 `Screenshot` renders frames offscreen at their real widths and returns how many it took; the images come back with the

package/dist/src-tY0sf-AQ.mjs

@@ -1,5 +0,0 @@
-import "./schema-CemdtCeF.mjs";
-import "./client-BtxrNeIk.mjs";
-export { t as componentNode, T as generateId, n as librarySource, i as withLibraryContext } from "./src-Csdxx4kB.mjs";
-import "./src-CzZ9eIU8.mjs";
-import "./src-CPka3fhs.mjs";