@parity-app/cli 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -1,36 +1,220 @@
-/** Where the running app writes its address and token. */
-export declare const agentFile: string;
-export interface Screenshot {
+/**
+ * Where running copies of Parity say how to reach them (PAR-514): one entry per copy, named by its main process, in
+ * `~/.parity/agents`. Each copy writes and removes only its own. The app and the CLI both go through here, so the
+ * format and the place live in one module. What a copy has open isn't here: the CLI asks each copy, live.
+ *
+ * `PARITY_AGENT_FILE` names one file instead, for a copy kept apart from the person's, as `pnpm perf`, the end-to-end
+ * tests and the backtest run: that copy writes only that file, and a CLI given it reaches only that copy.
+ */
+interface Registry {
+  /** The folder of entries, or the one file a copy kept apart uses. */
+  kind: "folder" | "file";
+  path: string;
+}
+/**
+ * Why an agent's call failed, as a stable code it can act on without reading the message. The CLI and MCP publish
+ * these; the app throws them where it knows the cause.
+ */
+declare const errorCodes: readonly [
+/** The request is malformed: a field is missing, of the wrong type or out of range. */
+"invalid_input",
+/** The app isn't running, so there's nowhere to send the call. */
+"not_running",
+/** The app is running but didn't answer. */
+"not_answering", "unknown_tab",
+/** The tab is still opening, or failed to open. */
+"tab_not_ready", "unknown_design", "unknown_node",
+/** A reference matches more than one thing; the alternatives say how to name each. */
+"ambiguous_reference", "unknown_state", "unknown_mode", "unknown_viewport", "unknown_component", "unknown_icon_set",
+/** A retry named a failed snippet the app doesn't have, so the whole snippet has to be sent again. */
+"unknown_edit_id",
+/** The call's changes collided with edits made in the editor meanwhile. Running it again may succeed. */
+"conflict",
+/** A snippet threw. Retry it with its editId and edits. */
+"execution_failed",
+/** Anything else the app reported. */
+"app_error"];
+type ErrorCode = (typeof errorCodes)[number];
+/**
+ * A failed call, the same in CLI `--json` and MCP `structuredContent`: a stable code to branch on, the message people
+ * read, whether the same request can succeed when sent again, the input at fault, and what to use instead.
+ */
+interface OperationError {
+  code: ErrorCode;
+  message: string;
+  /** Whether sending the same request again, unchanged, can succeed: the app was starting, or edits collided. */
+  retryable: boolean;
+  /** A JSON pointer to the input at fault, such as `/design` or `/edits/0/find`, in the operation's field names. */
+  path?: string;
+  /** Valid ids to use instead of an unknown or ambiguous one, closest first, at most 20. */
+  alternatives?: string[];
+  /** A failed snippet's id: retry it with `editId` and `edits` instead of sending it again. */
+  editId?: string;
+}
+interface Edit {
+  find: string;
+  replace: string;
+  all?: boolean;
+}
+interface Screenshot {
   path: string;
   png: string;
   design: string;
   state: string;
   mode: string;
 }
-export interface ExecResponse {
+/** The canonical result. Structured output is this without the screenshots' image data. */
+interface ExecResponse {
   ok: boolean;
   applied: boolean;
   output: string[];
   warnings: string[];
-  error?: string;
-  editId?: string;
+  /** Set when the call failed, with the editId to retry a snippet by. */
+  error?: OperationError;
   created: Record<string, string>;
   screenshots: Screenshot[];
 }
-export interface Edit {
-  find: string;
-  replace: string;
-  all?: boolean;
-}
+/**
+ * Where running copies of the app say how to reach them: `~/.parity/agents`, or the one file `PARITY_AGENT_FILE` names
+ * for a copy kept apart from the person's.
+ */
+export declare const registry: Registry;
 /**
  * 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.
  */
 export declare function setCaller(name: string | undefined, session?: boolean): void;
-/** Calls the running Parity app. Fails with a clear message when it isn't running. */
-export declare function call<T>(method: string, params?: Record<string, unknown>): Promise<T>;
+/**
+ * How a call finds its copy of the app (PAR-514): `tab` goes to the copy that has the tab's project open, `open` to the
+ * copy that has the project or else the one the person used last, and `copies` asks every copy, for their tabs.
+ */
+export type Routing = "tab" | "open" | "copies";
+/**
+ * Calls the running Parity app: the copy that has the call's project open, with the exact tab it chose, by the rules
+ * in `@parity-app/agent/routing`. 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<T>(method: string, params?: Record<string, unknown>, routing?: Routing): Promise<T>;
 /** A readable account of an exec call, for terminals and for agents. */
 export declare function describeExec(result: ExecResponse): string;
+/** One open project. */
+export interface TabSummary {
+  id: string;
+  name: string;
+  root: string;
+  active: boolean;
+  status: "loading" | "ready" | "error";
+  error?: string;
+  designs: number;
+}
+export interface TabsResponse {
+  tabs: TabSummary[];
+}
+export interface StatusResponse {
+  tab: {
+    id: string;
+    name: string;
+  };
+  /** Opaque: the same only while nothing in the tab has changed. */
+  revision: string;
+  /** Something applied (and undoable) isn't on disk yet. */
+  dirty: boolean;
+  /** Changes save themselves a moment later; otherwise they wait for the person to save. */
+  autosave: boolean;
+  unsaved: {
+    path: string;
+    kind: "document" | "stylesheet";
+    designs?: {
+      added: string[];
+      changed: string[];
+      removed: string[];
+    };
+    modes?: boolean;
+    tokens?: string[];
+    more?: number;
+  }[];
+  tokenEdits: number;
+  save: {
+    status: "saved" | "unsaved" | "saving" | "failed";
+    error?: string;
+  };
+  errors: {
+    path: string;
+    error: string;
+  }[];
+  undo: {
+    count: number;
+    labels?: string[];
+  };
+  redo: {
+    count: number;
+    labels?: string[];
+  };
+}
+/** Where a tab's edits stand: the revision, what's applied and undoable, what's on disk, and what failed to write. */
+export declare function describeStatus(result: StatusResponse): string;
+export interface ModesResponse {
+  tab: {
+    id: string;
+    name: string;
+  };
+  variables: {
+    id: string;
+    name: string;
+    kind: "viewport" | "theme" | "locale" | "custom";
+    options: {
+      id: string;
+      name: string;
+      width?: number;
+      height?: number;
+      device?: string;
+      className?: string;
+      attributes?: Record<string, string>;
+    }[];
+  }[];
+  /** Viewport options: the ids Responsive takes, with the window each stands for. */
+  viewports: {
+    id: string;
+    name: string;
+    width: number;
+    height: number;
+    device?: string;
+  }[];
+  /** Modes: the ids renders take, each a combination of one option per variable. */
+  modes: {
+    id: string;
+    name: string;
+    primary: boolean;
+    viewport: string;
+    width: number;
+    height: number;
+    values: Record<string, string>;
+    classNames: string[];
+    attributes: Record<string, string>;
+  }[];
+  designs: {
+    id: string;
+    name: string;
+    state: string;
+    states: string[];
+    main: string;
+    beside: string[];
+    frames?: {
+      mode: string;
+      width: number;
+      height?: number;
+      window: {
+        width: number;
+        height: number;
+      };
+    }[];
+  }[];
+}
+/**
+ * The project's viewports (what Responsive takes), its other variables, its modes (what renders take) and what each
+ * design's board shows, with a named design's frames.
+ */
+export declare function describeModes(result: ModesResponse): string;
 export interface AccessibilityFinding {
   state: string;
   mode: string;
@@ -86,8 +270,14 @@ export interface TokenInfo {
   source: string;
   values: Record<string, string>;
 }
+export interface TokensResponse {
+  tokens: TokenInfo[];
+  /** How many matched, before the limit. */
+  total: number;
+  truncated: boolean;
+}
 /** Tokens by category, each with its value in every theme that sets one. */
-export declare function describeTokens(tokens: TokenInfo[]): string;
+export declare function describeTokens({ tokens, total, truncated }: TokensResponse): string;
 export interface ComponentsResponse {
   components: string[];
   iconLibraries?: string[];
@@ -106,10 +296,9 @@ export interface ComponentsResponse {
     problem: "provider" | "server" | "async" | "error";
     reason: string;
   }[];
-  /** The person's corrections in the main project file, saved or not: exports listed by hand, and ones taken off. */
+  /** The person's corrections in the main project file, saved or not: exports listed by hand. */
   corrections?: {
     include?: ComponentRef[];
-    exclude?: ComponentRef[];
   };
 }
 /** One of the app's exports, by its file and export name. */
@@ -154,7 +343,12 @@ export interface ConsoleResponse {
     id: string;
     name: string;
   };
+  /** The newest entries, up to the limit, oldest first. */
   entries: ConsoleEntry[];
+  /** How many there were, before the limit. */
+  total: number;
+  truncated: boolean;
 }
 /** A readable account of what a project's code wrote to the console, oldest first, with where each came from. */
-export declare function describeConsole(result: ConsoleResponse): string;
+export declare function describeConsole(result: ConsoleResponse): string;
+export type { Edit, ExecResponse, OperationError, Screenshot };

package/dist/index.mjs

@@ -1 +1 @@
-export { t as agentFile, n as call, r as describeAccessibility, i as describeComponents, a as describeConsole, o as describeExec, s as describeProblems, c as describeProps, l as describeTokens, u as setCaller } from "./client-DsTLQ2lT.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-Cf66-n3R.mjs";

package/dist/libraries/aria.lib.par

@@ -4061,7 +4061,7 @@
           "children": [
             {
               "$render": [
-                "DropzoneArea isHovered: isFocused: isFocusVisible: isDropTar"
+                "DropzoneArea isHovered: isFocused: isFocusVisible…"
               ]
             }
           ]
@@ -9023,7 +9023,7 @@
               "children": [
                 {
                   "$render": [
-                    "Details Drag the handle up to expand this sheet to full heig"
+                    "Details Drag the handle up to expand this sheet to full…"
                   ]
                 }
               ]
@@ -9235,7 +9235,7 @@
           "children": [
             {
               "$render": [
-                "Sign up First Name: Last Name: Submit In an iPhone app, cons"
+                "Sign up First Name: Last Name: Submit In an iPhone app…"
               ]
             }
           ]
@@ -9365,7 +9365,7 @@
                   "children": [
                     {
                       "$render": [
-                        "Details Drag the handle up to expand this sheet to full heig"
+                        "Details Drag the handle up to expand this sheet to full…"
                       ]
                     }
                   ]
@@ -9512,7 +9512,7 @@
                       "children": [
                         {
                           "$render": [
-                            "Details Drag the handle up to expand this sheet to full heig"
+                            "Details Drag the handle up to expand this sheet to full…"
                           ]
                         }
                       ]

package/dist/libraries/baseui.lib.par

@@ -58,7 +58,7 @@
             {
               "component": "Accordion.Panel",
               "children": [
-                "Base UI is a library of high-quality unstyled React componen"
+                "Base UI is a library of high-quality unstyled React…"
               ]
             }
           ]
@@ -83,7 +83,7 @@
         "parentsFrom": "example",
         "sample": {
           "children": [
-            "Base UI is a library of high-quality unstyled React componen"
+            "Base UI is a library of high-quality unstyled React…"
           ]
         },
         "fingerprint": "a6e70d5d",
@@ -120,7 +120,7 @@
                 {
                   "component": "Accordion.Panel",
                   "children": [
-                    "Standard shipping takes 3–5 business days. Express delivery "
+                    "Standard shipping takes 3–5 business days."
                   ]
                 }
               ]
@@ -142,7 +142,7 @@
                 {
                   "component": "Accordion.Panel",
                   "children": [
-                    "You can return any item within 30 days of delivery. Opened i"
+                    "You can return any item within 30 days of delivery."
                   ]
                 }
               ]
@@ -164,7 +164,7 @@
                 {
                   "component": "Accordion.Panel",
                   "children": [
-                    "Yes, we ship to over 40 countries. International orders typi"
+                    "Yes, we ship to over 40 countries."
                   ]
                 }
               ]
@@ -186,7 +186,7 @@
                 {
                   "component": "Accordion.Panel",
                   "children": [
-                    "Once your order ships, you’ll receive a tracking link by ema"
+                    "Once your order ships, you’ll receive a tracking link by…"
                   ]
                 }
               ]
@@ -1705,7 +1705,7 @@
                 "Right click here"
               ]
             },
-            "Add to Library Add to Playlist Play Next Play Last Favorite "
+            "Add to Library Add to Playlist Play Next Play Last Favorite…"
           ]
         },
         "fingerprint": "163e37d4",
@@ -1996,7 +1996,7 @@
             {
               "component": "Dialog.Popup",
               "children": [
-                "Dialog This layout keeps the popup fully on screen while all",
+                "Dialog This layout keeps the popup fully on screen while…",
                 "Close"
               ]
             }
@@ -2088,11 +2088,11 @@
             {
               "component": "Drawer.Description",
               "children": [
-                "Review sign-in activity and update your security preferences"
+                "Review sign-in activity and update your security…"
               ]
             },
-            "Passkeys enabled 2FA via authenticator app 3 signed-in devic",
-            "Advanced options Advanced This drawer is taller to demonstra"
+            "Passkeys enabled 2FA via authenticator app 3 signed-in…",
+            "Advanced options Advanced This drawer is taller to…"
           ]
         },
         "fingerprint": "c413c506",
@@ -2115,7 +2115,7 @@
         "parentsFrom": "example",
         "sample": {
           "children": [
-            "This is a drawer that slides in from the side. You can swipe"
+            "This is a drawer that slides in from the side."
           ]
         },
         "fingerprint": "beb84af4",
@@ -2134,7 +2134,7 @@
         "parentsFrom": "example",
         "sample": {
           "children": [
-            "Open drawer Notifications You are all caught up. Good job! C"
+            "Open drawer Notifications You are all caught up. Good job!"
           ]
         },
         "fingerprint": "141c3ab0",
@@ -2181,11 +2181,11 @@
                 {
                   "component": "Drawer.Description",
                   "children": [
-                    "Review sign-in activity and update your security preferences"
+                    "Review sign-in activity and update your security…"
                   ]
                 },
-                "Passkeys enabled 2FA via authenticator app 3 signed-in devic",
-                "Advanced options Advanced This drawer is taller to demonstra"
+                "Passkeys enabled 2FA via authenticator app 3 signed-in…",
+                "Advanced options Advanced This drawer is taller to…"
               ]
             }
           ]
@@ -2251,7 +2251,7 @@
         "visual": false,
         "sample": {
           "children": [
-            "Open drawer Notifications You are all caught up. Good job! C"
+            "Open drawer Notifications You are all caught up. Good job!"
           ]
         },
         "fingerprint": "a761e30b",
@@ -2417,11 +2417,11 @@
                     {
                       "component": "Drawer.Description",
                       "children": [
-                        "Review sign-in activity and update your security preferences"
+                        "Review sign-in activity and update your security…"
                       ]
                     },
-                    "Passkeys enabled 2FA via authenticator app 3 signed-in devic",
-                    "Advanced options Advanced This drawer is taller to demonstra"
+                    "Passkeys enabled 2FA via authenticator app 3 signed-in…",
+                    "Advanced options Advanced This drawer is taller to…"
                   ]
                 }
               ]
@@ -5909,8 +5909,8 @@
         "parentsFrom": "example",
         "sample": {
           "children": [
-            "Vernacular architecture is building done outside any academi",
-            "This type of architecture usually serves immediate, local ne"
+            "Vernacular architecture is building done outside any…",
+            "This type of architecture usually serves immediate, local…"
           ]
         },
         "fingerprint": "1c72c9cc",
@@ -6030,8 +6030,8 @@
             {
               "component": "ScrollArea.Content",
               "children": [
-                "Vernacular architecture is building done outside any academi",
-                "This type of architecture usually serves immediate, local ne"
+                "Vernacular architecture is building done outside any…",
+                "This type of architecture usually serves immediate, local…"
               ]
             }
           ]
@@ -7259,7 +7259,7 @@
                 }
               ]
             },
-            "Workspace stats and activity. Milestones and deadlines. Prof"
+            "Workspace stats and activity. Milestones and deadlines."
           ]
         },
         "fingerprint": "53a7c0df",

package/dist/libraries/chakra.lib.par

@@ -7275,7 +7275,7 @@
                 {
                   "component": "Accordion.ItemBody",
                   "children": [
-                    "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Cur"
+                    "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
                   ]
                 }
               ]
@@ -11647,7 +11647,7 @@
                     {
                       "component": "Accordion.ItemBody",
                       "children": [
-                        "Click the accordion button to see a different style when exp"
+                        "Click the accordion button to see a different style when…"
                       ]
                     }
                   ]
@@ -11680,7 +11680,7 @@
                     {
                       "component": "Accordion.ItemBody",
                       "children": [
-                        "The trigger background changes to teal with white text when "
+                        "The trigger background changes to teal with white text when…"
                       ]
                     }
                   ]
@@ -31040,7 +31040,7 @@
             "cite": "Uzumaki Naruto"
           },
           "children": [
-            "If anyone thinks he is something when he is nothing, he dece"
+            "If anyone thinks he is something when he is nothing, he…"
           ]
         },
         "fingerprint": "ca28c419",
@@ -32776,7 +32776,7 @@
                 "cite": "Uzumaki Naruto"
               },
               "children": [
-                "If anyone thinks he is something when he is nothing, he dece"
+                "If anyone thinks he is something when he is nothing, he…"
               ]
             },
             {
@@ -42420,7 +42420,7 @@
                 "color": "gray.600"
               },
               "children": [
-                "This is the card body. Lorem ipsum dolor sit amet, consectet"
+                "This is the card body."
               ]
             }
           ]
@@ -45919,7 +45919,7 @@
                     "color": "gray.600"
                   },
                   "children": [
-                    "This is the card body. Lorem ipsum dolor sit amet, consectet"
+                    "This is the card body."
                   ]
                 }
               ]
@@ -143482,7 +143482,7 @@
             "fluid": true
           },
           "children": [
-            "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nul"
+            "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
           ]
         },
         "fingerprint": "29eb410f",
@@ -186407,7 +186407,7 @@
             {
               "component": "Dialog.Description",
               "children": [
-                "This dialog uses backdropFilter=\"auto\" and backdropBlur so t"
+                "This dialog uses backdropFilter=\"auto\" and backdropBlur so…"
               ]
             }
           ]
@@ -197034,7 +197034,7 @@
         "sample": {
           "children": [
             "Drawer is open:",
-            "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed",
+            "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
             "Close"
           ]
         },
@@ -199673,7 +199673,7 @@
                   },
                   "children": [
                     "Drawer is open:",
-                    "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed",
+                    "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
                     "Close"
                   ]
                 }
@@ -337542,7 +337542,7 @@
                 {
                   "component": "Popover.Description",
                   "children": [
-                    "A Japanese manga series written and illustrated by Masashi K"
+                    "A Japanese manga series written and illustrated by Masashi…"
                   ]
                 }
               ]
@@ -338452,7 +338452,7 @@
         "parentsFrom": "example",
         "sample": {
           "children": [
-            "A Japanese manga series written and illustrated by Masashi K"
+            "A Japanese manga series written and illustrated by Masashi…"
           ]
         },
         "fingerprint": "ca28c419",
@@ -340190,7 +340190,7 @@
             {
               "component": "Popover.Description",
               "children": [
-                "A Japanese manga series written and illustrated by Masashi K"
+                "A Japanese manga series written and illustrated by Masashi…"
               ]
             }
           ]
@@ -341074,7 +341074,7 @@
                     {
                       "component": "Popover.Description",
                       "children": [
-                        "A Japanese manga series written and illustrated by Masashi K"
+                        "A Japanese manga series written and illustrated by Masashi…"
                       ]
                     }
                   ]
@@ -413986,7 +413986,7 @@
             "loading": false
           },
           "children": [
-            "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pro"
+            "Lorem ipsum dolor sit amet, consectetur adipiscing elit."
           ]
         },
         "fingerprint": "eac0f96c",
@@ -488299,7 +488299,7 @@
             {
               "component": "Tag.Label",
               "children": [
-                "Lorem ipsum dolor sit amet consectetur adipisicing elit. Qui"
+                "Lorem ipsum dolor sit amet consectetur adipisicing elit."
               ]
             },
             {