@iamu-dev/iamu 0.2.0-beta.1 → 0.2.0-beta.2

package/dist/bin.js

@@ -12388,10 +12388,10 @@ var init_registry = __esm({
       {
         name: "Antigravity",
         value: "antigravity",
-        detectionPaths: [".gemini", ".agent", "GEMINI.md", "AGENTS.md"],
+        detectionPaths: [".agent", ".agents", "AGENTS.md", ".gemini", "GEMINI.md"],
         supportsSkills: true,
-        getSkillsDir: (root) => existsSync3(join3(root, ".agent")) && !existsSync3(join3(root, ".gemini")) ? join3(root, ".agent", "skills") : join3(root, ".gemini", "skills"),
-        getCommandPath: (root, id) => existsSync3(join3(root, ".agent")) && !existsSync3(join3(root, ".gemini")) ? join3(root, ".agent", "skills", `iamu-${id}`, "SKILL.md") : join3(root, ".gemini", "skills", `iamu-${id}`, "SKILL.md"),
+        getSkillsDir: (root) => existsSync3(join3(root, ".agents")) ? join3(root, ".agents", "skills") : join3(root, ".agent", "skills"),
+        getCommandPath: (root, id) => existsSync3(join3(root, ".agents")) ? join3(root, ".agents", "skills", `iamu-${id}`, "SKILL.md") : join3(root, ".agent", "skills", `iamu-${id}`, "SKILL.md"),
         formatCommand: richFormat,
         getMcpConfigPath: (root) => join3(root, ".mcp.json"),
         formatMcpConfig: mcpJson
@@ -12546,6 +12546,20 @@ function planSkillFiles(hosts, projectRoot, version2) {
       for (const [name, content] of skillTemplates) {
         files.push({ host, path: join4(skillsDir, name, "SKILL.md"), content });
       }
+      if (host.value === "antigravity") {
+        for (const name of skillTemplates.keys()) {
+          const legacyPath = join4(
+            projectRoot,
+            ".gemini",
+            "skills",
+            name,
+            "SKILL.md"
+          );
+          if (isCliWrittenSkill(legacyPath)) {
+            files.push({ host, path: legacyPath, content: null });
+          }
+        }
+      }
     } else {
       for (const cmd of commandsFromSkills(skillTemplates)) {
         files.push({
@@ -12636,7 +12650,13 @@ async function installSkillsForHosts(hosts, projectRoot, version2, opts) {
     let hostUpdated = 0;
     let hostTotal = 0;
     for (const f of planned) {
-      if (f.host !== host || f.content === null) continue;
+      if (f.host !== host) continue;
+      if (f.content === null) {
+        await rm(f.path, { force: true });
+        await rmdir(dirname3(f.path)).catch(() => {
+        });
+        continue;
+      }
       hostTotal++;
       if (host.supportsSkills) totalSkills++;
       else totalCommands++;
@@ -15744,7 +15764,8 @@ var init_serve = __esm({
 // src/commands/init.ts
 var init_exports = {};
 __export(init_exports, {
-  init: () => init
+  init: () => init,
+  setupCommand: () => setupCommand
 });
 import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
 import { mkdir as mkdir4, writeFile as writeFile3 } from "fs/promises";
@@ -15771,9 +15792,9 @@ function loadPromptTemplates() {
   return templates;
 }
 function setupCommand(projectRoot, hosts) {
-  if (!iamuPluginEnabled(projectRoot)) return "iamu-setup";
+  if (!iamuPluginEnabled(projectRoot)) return "/iamu-setup";
   if (hosts.every((h) => h.value === "claude")) return "/iamu:init";
-  return "iamu-setup   (Claude Code: /iamu:init)";
+  return "/iamu-setup   (Claude Code: /iamu:init)";
 }
 async function init(opts) {
   const options = typeof opts === "string" ? { name: opts } : opts ?? {};
@@ -15917,7 +15938,7 @@ async function init(opts) {
   if (freshInit) {
     console.log(chalk17.bold("  Next step:"));
     console.log();
-    console.log(chalk17.dim("  Open your editor and run:"));
+    console.log(chalk17.dim("  In your AI agent chat, run:"));
     console.log();
     console.log(`    ${chalk17.cyan(setupCommand(projectRoot, selectedHosts))}`);
     console.log();

package/dist/index.js

@@ -12367,10 +12367,10 @@ var init_registry = __esm({
       {
         name: "Antigravity",
         value: "antigravity",
-        detectionPaths: [".gemini", ".agent", "GEMINI.md", "AGENTS.md"],
+        detectionPaths: [".agent", ".agents", "AGENTS.md", ".gemini", "GEMINI.md"],
         supportsSkills: true,
-        getSkillsDir: (root) => existsSync3(join3(root, ".agent")) && !existsSync3(join3(root, ".gemini")) ? join3(root, ".agent", "skills") : join3(root, ".gemini", "skills"),
-        getCommandPath: (root, id) => existsSync3(join3(root, ".agent")) && !existsSync3(join3(root, ".gemini")) ? join3(root, ".agent", "skills", `iamu-${id}`, "SKILL.md") : join3(root, ".gemini", "skills", `iamu-${id}`, "SKILL.md"),
+        getSkillsDir: (root) => existsSync3(join3(root, ".agents")) ? join3(root, ".agents", "skills") : join3(root, ".agent", "skills"),
+        getCommandPath: (root, id) => existsSync3(join3(root, ".agents")) ? join3(root, ".agents", "skills", `iamu-${id}`, "SKILL.md") : join3(root, ".agent", "skills", `iamu-${id}`, "SKILL.md"),
         formatCommand: richFormat,
         getMcpConfigPath: (root) => join3(root, ".mcp.json"),
         formatMcpConfig: mcpJson
@@ -12525,6 +12525,20 @@ function planSkillFiles(hosts, projectRoot, version) {
       for (const [name, content] of skillTemplates) {
         files.push({ host, path: join4(skillsDir, name, "SKILL.md"), content });
       }
+      if (host.value === "antigravity") {
+        for (const name of skillTemplates.keys()) {
+          const legacyPath = join4(
+            projectRoot,
+            ".gemini",
+            "skills",
+            name,
+            "SKILL.md"
+          );
+          if (isCliWrittenSkill(legacyPath)) {
+            files.push({ host, path: legacyPath, content: null });
+          }
+        }
+      }
     } else {
       for (const cmd of commandsFromSkills(skillTemplates)) {
         files.push({
@@ -12615,7 +12629,13 @@ async function installSkillsForHosts(hosts, projectRoot, version, opts) {
     let hostUpdated = 0;
     let hostTotal = 0;
     for (const f of planned) {
-      if (f.host !== host || f.content === null) continue;
+      if (f.host !== host) continue;
+      if (f.content === null) {
+        await rm(f.path, { force: true });
+        await rmdir(dirname3(f.path)).catch(() => {
+        });
+        continue;
+      }
       hostTotal++;
       if (host.supportsSkills) totalSkills++;
       else totalCommands++;
@@ -15723,7 +15743,8 @@ var init_serve = __esm({
 // src/commands/init.ts
 var init_exports = {};
 __export(init_exports, {
-  init: () => init
+  init: () => init,
+  setupCommand: () => setupCommand
 });
 import { existsSync as existsSync7, readFileSync as readFileSync5 } from "fs";
 import { mkdir as mkdir4, writeFile as writeFile3 } from "fs/promises";
@@ -15750,9 +15771,9 @@ function loadPromptTemplates() {
   return templates;
 }
 function setupCommand(projectRoot, hosts) {
-  if (!iamuPluginEnabled(projectRoot)) return "iamu-setup";
+  if (!iamuPluginEnabled(projectRoot)) return "/iamu-setup";
   if (hosts.every((h) => h.value === "claude")) return "/iamu:init";
-  return "iamu-setup   (Claude Code: /iamu:init)";
+  return "/iamu-setup   (Claude Code: /iamu:init)";
 }
 async function init(opts) {
   const options = typeof opts === "string" ? { name: opts } : opts ?? {};
@@ -15896,7 +15917,7 @@ async function init(opts) {
   if (freshInit) {
     console.log(chalk17.bold("  Next step:"));
     console.log();
-    console.log(chalk17.dim("  Open your editor and run:"));
+    console.log(chalk17.dim("  In your AI agent chat, run:"));
     console.log();
     console.log(`    ${chalk17.cyan(setupCommand(projectRoot, selectedHosts))}`);
     console.log();

package/dist/templates/skills/iamu-setup.md

@@ -23,22 +23,14 @@ $ARGUMENTS
 
 ### 1. Scaffold the iamu/ tree
 
-Run `iamu init` in the terminal. Pass a project name when the user names one explicitly; otherwise the tool derives it from the directory basename.
-
-```
-iamu init [project-name]
-```
-
-The command scaffolds `iamu/config.json`, entity subdirs, `.runs/`, `.cache/`, `.gitignore`.
-
-- If `iamu/` was already present, existing files are not overwritten. Treat as success and continue.
-- Error containing "legacy `.iamu/` layout" → tell the user to remove the legacy directory, then re-run.
-
-On fresh scaffold, introduce iamu first:
-
-> **iamu** tests your product as realistic personas and reports what works, what doesn't, and how to fix it. I'll analyze your codebase now to understand the domain and propose primary personas.
-
-On re-run (already scaffolded), skip the intro — the user knows what iamu is.
+Check whether `iamu/config.json` already exists:
+
+- **If already scaffolded (`iamu/config.json` exists):** Do not re-run `iamu init`. Introduce the step concisely and proceed directly to Step 2:
+  > Analyzing your codebase now to understand the domain and propose primary personas.
+- **If not yet scaffolded:** Run `iamu init [project-name]` in the terminal (pass a project name if the user named one explicitly; otherwise omit). The command scaffolds `iamu/config.json`, entity subdirs, `.runs/`, `.cache/`, `.gitignore`.
+  Introduce iamu first:
+  > **iamu** tests your product as realistic personas and reports what works, what doesn't, and how to fix it. I'll analyze your codebase now to understand the domain and propose primary personas.
+- **Error containing "legacy `.iamu/` layout"** → tell the user to remove the legacy directory, then re-run.
 
 ### 2. Understand the project
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iamu-dev/iamu",
-  "version": "0.2.0-beta.1",
+  "version": "0.2.0-beta.2",
   "type": "module",
   "description": "Test your product as realistic personas — scenario-driven development CLI",
   "license": "UNLICENSED",
@@ -57,9 +57,9 @@
     "tsup": "^8.5.1",
     "typescript": "^5.8.0",
     "vitest": "^4.1.11",
-    "@iamu-dev/protocol": "0.1.0",
     "@iamu-dev/local-store": "0.1.0",
-    "@iamu/tsconfig": "0.1.0"
+    "@iamu/tsconfig": "0.1.0",
+    "@iamu-dev/protocol": "0.1.0"
   },
   "scripts": {
     "build": "tsup && tsc -b tsconfig.build.json --emitDeclarationOnly && node scripts/copy-assets.mjs",

package/dist/adapters/claude-plugin.d.ts

@@ -1,13 +0,0 @@
-import type { HostAdapter } from "./types.js";
-/**
- * Whether the Iamu Claude Code plugin is enabled for `projectRoot`.
- * Settings merge key by key and the highest-precedence mention wins, so
- * `"iamu@iamu": false` in settings.local.json overrides a user-level true.
- */
-export declare function iamuPluginEnabled(projectRoot: string): boolean;
-/**
- * The plugin ships the same skills as `/iamu:<name>`. Claude Code loads
- * plugin and project skills side by side, so installing both would put
- * every skill in context twice.
- */
-export declare function pluginProvidesSkills(host: HostAdapter, projectRoot: string): boolean;

package/dist/adapters/registry.d.ts

@@ -1,6 +0,0 @@
-import type { HostAdapter } from "./types.js";
-export declare const HOST_ADAPTERS: HostAdapter[];
-/**
- * Detect which host editors are present in the given project root.
- */
-export declare function detectHosts(projectRoot: string): HostAdapter[];

package/dist/adapters/types.d.ts

@@ -1,19 +0,0 @@
-export interface CommandContent {
-    id: string;
-    name: string;
-    description: string;
-    category: string;
-    tags: string[];
-    body: string;
-}
-export interface HostAdapter {
-    name: string;
-    value: string;
-    detectionPaths: string[];
-    supportsSkills: boolean;
-    getSkillsDir(projectRoot: string): string;
-    getCommandPath(projectRoot: string, commandId: string): string;
-    formatCommand(content: CommandContent): string;
-    getMcpConfigPath(projectRoot: string): string;
-    formatMcpConfig(serverCommand: string[]): string;
-}

package/dist/bin.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/build-info.d.ts

@@ -1,53 +0,0 @@
-import { type BuildMetadata } from "@iamu-dev/protocol";
-import { type WorktreeDetector } from "./worktree-state.js";
-/** Environment variables, as `process.env` holds them. */
-export type Env = Record<string, string | undefined>;
-/** Runs `git <args>` in `cwd`; returns trimmed stdout or null. */
-export type GitRunner = (args: string[], cwd: string) => string | null;
-/** `git` via execFile, silent and bounded; null when git is absent or fails. */
-export declare const runGit: GitRunner;
-interface CiInfo {
-    git_sha?: string;
-    git_branch?: string;
-    base_sha?: string;
-    ci?: {
-        provider: string;
-        run_url: string;
-    };
-}
-/**
- * What the CI environment says about the build. Recognizes GitHub
- * Actions and Azure Pipelines; an empty object anywhere else.
- */
-export declare function detectCi(env: Env): CiInfo;
-export interface DetectBuildOptions {
-    /** `--build <label>`. */
-    label?: string;
-    /** Directory to ask git about. */
-    cwd: string;
-    env?: Env;
-    git?: GitRunner;
-    /**
-     * Uncommitted changes outside `iamu/` (`git_dirty`, `worktree_hash`).
-     * Recorded alongside a `--build` label, not instead of it.
-     */
-    worktree?: WorktreeDetector;
-}
-/**
- * Build metadata for a run started now. Flags win over CI variables,
- * CI variables over the local checkout. Returns undefined when nothing
- * at all is known.
- *
- * @example
- * ```ts
- * const build = detectBuild({ cwd: projectRoot, label: "2.4.0" });
- * // { label: "2.4.0", git_sha: "3f9c2a1…", git_branch: "main", git_dirty: false }
- * ```
- */
-export declare function detectBuild(opts: DetectBuildOptions): BuildMetadata | undefined;
-/**
- * The run's environment: `--env <name>` when given, otherwise the
- * target URL's origin.
- */
-export declare function resolveEnvironment(explicit: string | undefined, targetUrl: string): string | undefined;
-export {};

package/dist/cloud-url.d.ts

@@ -1,19 +0,0 @@
-/**
- * Resolves cloud web dashboard URLs for projects and walkthrough runs.
- */
-/**
- * Resolves the web dashboard base URL from an API URL or environment variable.
- *
- * Precedence:
- * 1. IAMU_WEB_URL environment variable (explicit override)
- * 2. If apiUrl targets api.iamu.dev -> https://app.iamu.dev
- * 3. If apiUrl targets localhost:3000 -> http://localhost:3001 (standard local dev split)
- *    unless overridden by IAMU_WEB_URL
- * 4. If apiUrl starts with https://api. -> https://app.
- * 5. Fallback: apiUrl without trailing slash
- */
-export declare function getCloudWebBase(apiUrl?: string | null): string;
-/**
- * Builds the cloud dashboard URL for a project or specific walkthrough run.
- */
-export declare function getCloudDashboardUrl(apiUrl: string | null | undefined, projectId: string, walkthroughId?: string): string;

package/dist/commands/auth-http.d.ts

@@ -1,37 +0,0 @@
-/** Per-request budget for auth endpoints, headers plus body. */
-export declare const AUTH_REQUEST_TIMEOUT_MS = 10000;
-/** A fully read response from an auth endpoint. */
-export interface AuthHttpResponse {
-    status: number;
-    ok: boolean;
-    /** Raw body text. */
-    text: string;
-    /** Body parsed as JSON, or `null` when it is not JSON. */
-    json: unknown;
-}
-/** Request options for {@link requestAuthApi}. */
-export interface AuthRequestOptions {
-    method?: "GET" | "POST";
-    headers?: Record<string, string>;
-    body?: string;
-    /** Budget for this request; default {@link AUTH_REQUEST_TIMEOUT_MS}. */
-    timeoutMs?: number;
-}
-/**
- * Call an auth endpoint and read the whole body within `timeoutMs`.
- *
- * @param url - Absolute endpoint URL.
- * @param opts - Method, headers, body and timeout.
- * @returns Status plus the body as text and (when parseable) JSON.
- * @throws {@link IamuNetworkError} when the timeout fires; other fetch
- *   failures propagate unchanged.
- *
- * @example
- * ```ts
- * const res = await requestAuthApi(`${apiUrl}/api/projects`, {
- *   headers: { Authorization: `Bearer ${token}` },
- * });
- * if (res.ok) console.log(res.json);
- * ```
- */
-export declare function requestAuthApi(url: string, opts?: AuthRequestOptions): Promise<AuthHttpResponse>;

package/dist/commands/auth-project-choice.d.ts

@@ -1,74 +0,0 @@
-/**
- * Which cloud project `iamu auth login` links to. Pure, so every branch
- * is testable without a TTY or network.
- *
- * Linking pushes every local entity to the chosen project, so a wrong
- * guess leaks one product's data into another. The rules therefore
- * never pick between several projects on the user's behalf.
- */
-/** A cloud project as `GET /api/projects` lists it. */
-export interface CloudProjectSummary {
-    id: string;
-    name: string;
-    slug: string;
-}
-/** `--project` value that asks for a new cloud project. */
-export declare const CREATE_NEW_PROJECT = "new";
-/** Inputs to {@link decideCloudProject}. */
-export interface ProjectChoiceInput {
-    /** Projects the account can see. */
-    projects: readonly CloudProjectSummary[];
-    /** `--project` value, if given. */
-    requested?: string;
-    /** Project this repo is already linked to (credentials were lost). */
-    linkedProjectId?: string | null;
-    /** `--yes`: accept the only candidate. */
-    yes?: boolean;
-    /** Whether a human can be prompted. */
-    interactive: boolean;
-}
-/** Outcome of {@link decideCloudProject}. */
-export type ProjectDecision = {
-    kind: "link";
-    projectId: string;
-} | {
-    kind: "create";
-} | {
-    kind: "prompt";
-} | {
-    kind: "refuse";
-    reason: "ambiguous" | "unknown_project";
-};
-/**
- * Decide the project to link.
- *
- * - `--project new` creates; `--project <id>` must be one of `projects`.
- * - An existing link is kept.
- * - No projects at all: create one named after the local project.
- * - `--yes` links the single project when there is exactly one; with
- *   several it does not pick, it falls through.
- * - Otherwise prompt when interactive, refuse (and list) when not.
- *
- * @param input - Available projects plus flags and TTY state.
- * @returns What to do next.
- *
- * @example
- * ```ts
- * const d = decideCloudProject({ projects, requested: "new", interactive: false });
- * // { kind: "create" }
- * ```
- */
-export declare function decideCloudProject(input: ProjectChoiceInput): ProjectDecision;
-/**
- * Narrow a `GET /api/projects` body to project summaries.
- *
- * @param body - Parsed JSON body.
- * @returns The projects, or `null` when the body is not a project list.
- *
- * @example
- * ```ts
- * const projects = parseProjectList(res.json);
- * if (!projects) throw new Error("unexpected response");
- * ```
- */
-export declare function parseProjectList(body: unknown): CloudProjectSummary[] | null;

package/dist/commands/auth-token-input.d.ts

@@ -1,21 +0,0 @@
-/** The readable side `readTokenFromStdin` needs. */
-export type TokenInputStream = AsyncIterable<string | Uint8Array> & {
-    isTTY?: boolean;
-};
-/**
- * Read an API token piped on stdin (`--token-stdin`), so it never shows
- * up in `ps`, shell history or CI logs the way `--token <value>` does.
- * Surrounding whitespace (a trailing newline from `echo`) is dropped.
- *
- * @param stream - Input stream; defaults to `process.stdin`.
- * @returns The token.
- * @throws {@link IamuValidationError} when stdin is a terminal, empty,
- *   oversized, or holds more than one word.
- *
- * @example
- * ```ts
- * // printf %s "$IAMU_CI_TOKEN" | iamu auth login --token-stdin
- * const token = await readTokenFromStdin();
- * ```
- */
-export declare function readTokenFromStdin(stream?: TokenInputStream): Promise<string>;

package/dist/commands/auth.d.ts

@@ -1,84 +0,0 @@
-/** Launches a program with its arguments as an argv array — no shell. */
-export type CommandRunner = (file: string, args: readonly string[]) => void;
-/**
- * Open `url` in the platform browser. The URL is always a separate argv
- * element: interpolating it into a shell command line let a crafted
- * login URL run commands.
- *
- * @param url - The URL to open.
- * @param run - Process launcher; injectable so tests never spawn.
- *
- * @example
- * ```ts
- * openBrowser("https://iamu.dev/login");
- * ```
- */
-export declare function openBrowser(url: string, run?: CommandRunner): void;
-/** Flags of `iamu auth login`. */
-export interface AuthLoginOptions {
-    url?: string;
-    /** Accept the only candidate project; never picks between several. */
-    yes?: boolean;
-    /** Cloud project id to link, or `new` to create one. */
-    project?: string;
-    browser?: boolean;
-    local?: boolean | string | number;
-    staging?: boolean;
-    /** Token on argv. Visible to `ps` and shell history; prefer `tokenStdin`. */
-    token?: string;
-    /** Read the token from stdin instead of argv. */
-    tokenStdin?: boolean;
-    webUrl?: string;
-}
-/**
- * Timing knobs for {@link authLogin}. Exposed so tests can shrink them.
- *
- * @internal
- */
-export interface AuthLoginTiming {
-    /** Pause between token polls. */
-    pollIntervalMs: number;
-    /** Hard deadline for the whole browser login. */
-    pollTimeoutMs: number;
-    /** Budget for each HTTP request. */
-    requestTimeoutMs: number;
-}
-/**
- * `iamu auth login`: obtain a token (flag, stdin, stored/env, or browser
- * device flow), store it, then link the project to a cloud project.
- * Every failure sets exit code 1 (2 for conflicting flags); in a
- * non-interactive shell it never chooses between cloud projects.
- *
- * @param opts - Command flags.
- * @param timing - Test-only timing overrides.
- *
- * @example
- * ```ts
- * await authLogin({ project: "new" });
- * ```
- */
-export declare function authLogin(opts?: AuthLoginOptions, timing?: Partial<AuthLoginTiming>): Promise<void>;
-/**
- * `iamu auth disconnect`: unlink the project and forget the stored token
- * for its API URL. Local entities are kept.
- *
- * @example
- * ```ts
- * await authDisconnect();
- * ```
- */
-export declare function authDisconnect(): Promise<void>;
-/**
- * `iamu auth status`: whether a token is available and the project is
- * linked. Never prints the token.
- *
- * @param opts - `json` prints a machine-readable object on stdout.
- *
- * @example
- * ```ts
- * await authStatus({ json: true });
- * ```
- */
-export declare function authStatus(opts?: {
-    json?: boolean;
-}): Promise<void>;

package/dist/commands/browse-actions.d.ts

@@ -1,56 +0,0 @@
-/**
- * The page actions `iamu browse` can perform — one table shared by the
- * direct commands (`iamu browse click …`) and by `iamu browse step
- * click …`, so the two can never drift apart.
- */
-import type { Page } from "playwright-core";
-/** Options an action reads. */
-export interface ActionOptions {
-    /** Pick the nth (0-based) match instead of the first. */
-    nth?: string;
-    /** Press Enter after fill/select. */
-    submit?: boolean;
-}
-/**
- * One page action: how it is called, what it targets (for the "nothing
- * matches" error), and what it does.
- *
- * @public
- */
-export interface PageAction {
-    /** Call shape after `iamu browse`, e.g. `click <role> "<name>" [--nth N]`. */
-    usage: string;
-    /** Positional arguments required after the action name. */
-    minArgs: number;
-    /** What the action looks for, named the way the error message says it. */
-    target?: (args: string[]) => string;
-    run(page: Page, args: string[], opts: ActionOptions): Promise<void>;
-}
-/**
- * Every page action, by name. `shot` does nothing to the page; the
- * screenshot is taken after any action when one is asked for.
- *
- * @example
- * ```ts
- * const action = PAGE_ACTIONS.click;
- * if (args.length >= action.minArgs) await action.run(page, args, {});
- * ```
- *
- * @public
- */
-export declare const PAGE_ACTIONS: Readonly<Record<string, PageAction>>;
-/**
- * Look up a page action by name, own properties only (so `toString`
- * and friends are not actions).
- *
- * @param name - The action name as typed.
- * @returns The action, or undefined.
- *
- * @example
- * ```ts
- * findPageAction("click")?.usage; // 'click <role> "<name>" [--nth N]'
- * ```
- *
- * @public
- */
-export declare function findPageAction(name: string): PageAction | undefined;