@mapled/cli 0.15.0 → 0.16.0

package/README.md

@@ -30,9 +30,10 @@ The browser opens Mapled on that project and the person clicks Authorize; nothin
 npx @mapled/cli tools
 npx @mapled/cli tool get_schema
 npx @mapled/cli tool propose_setup_plan --input plan.json
+npx @mapled/cli tool get_setup_run '{"runId":"…"}' --wait
 ```
 
-`tools` lists every tool with its input (`--json` for the schemas). `tool <name>` calls one — the same tools the [MCP server](https://www.npmjs.com/package/@mapled/mcp) offers, through the same connection: the input is a JSON object, inline or in a file with `--input`; the answer is printed as Mapled worded it, and a refusal exits 1.
+`tools` lists every tool with its input (`--json` for the schemas). `tool <name>` calls one — the same tools the [MCP server](https://www.npmjs.com/package/@mapled/mcp) offers, through the same connection: the input is a JSON object, inline or in a file with `--input`; the answer is printed as Mapled worded it, and a refusal exits 1. `tool get_setup_run '{"runId":"…"}' --wait` waits while the plan is still waiting for approval and prints the run once the person has decided on the Mapled screen — the agent carries on without being asked; it waits 90 seconds by default (`--wait=<seconds>`, up to 600) and then prints the run as it stands, so the agent runs the same command again.
 
 Do the work yourself: the person approves on Mapled screens (the connection, the plan, a destructive change) and is never sent to a terminal or to GitHub. Never ask for a token or a key in the conversation.
 
@@ -293,6 +294,7 @@ Prints a Preview link — the one the **Preview** button in Mapled opens: the si
 - `--no-browser` — print the sign-in link instead of opening a browser
 - `--project <id>` — the project `connect` and `auth login` open the consent on, and the one `project link` links
 - `--input <file>` — `tool` only: the tool's input as a JSON file
+- `--wait[=<seconds>]` — `tool get_setup_run` only: wait while the plan awaits approval (90 seconds by default, up to 600)
 - `--json` — machine-readable output (`tools`, `doctor`, `integration report`, `schema diff`, `scan`, `manifest validate`, `forms list`, `preview`)
 - `--load-config` — `doctor` only: let the site's installed Next load a next.config doctor can't read; runs the site's code, as `next build` does
 - `MAPLED_CONFIG_DIR` — where credentials live (default: `$XDG_CONFIG_HOME/mapled` or `~/.config/mapled`)

package/dist/commands.d.ts

@@ -17,6 +17,8 @@ export type Ctx = {
     credentialsFile: string;
     /** How long a sign-in waits for the browser (tests shorten it). */
     loginTimeoutMs?: number;
+    /** How often `tool get_setup_run --wait` asks again (tests shorten it). */
+    pollMs?: number;
 };
 type Flags = ParsedArgs["flags"];
 export declare function login(ctx: Ctx, flags: Flags): Promise<Connection>;

package/dist/commands.js

@@ -249,13 +249,51 @@ export async function tool(ctx, flags, words) {
     }
     if (args === null || typeof args !== "object" || Array.isArray(args))
         throw new CliError("The input must be a JSON object.");
+    const wait = waitSeconds(flags, name);
     const { session } = await openSession(ctx, flags);
-    const answer = await session.rpc("tools/call", { name, arguments: args });
+    const deadline = Date.now() + wait * 1000;
+    let answer = await session.rpc("tools/call", { name, arguments: args });
+    // the person approves on a Mapled screen, not in the agent's chat: the
+    // agent blocks here instead of ending its turn to wait for a word that
+    // never comes
+    while (wait > 0 && !answer.isError && awaitingApproval(answer) && Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, Math.min(ctx.pollMs ?? WAIT_POLL_MS, Math.max(0, deadline - Date.now()))));
+        answer = await session.rpc("tools/call", { name, arguments: args });
+    }
     for (const part of answer.content ?? [])
         if (part.type === "text" && part.text !== undefined)
             ctx.out(part.text);
     return answer.isError ? 1 : 0;
 }
+/** `--wait` waits this long by default: under the two minutes an agent's
+    shell gives a command unless it asks for more. */
+const WAIT_SECONDS = 90;
+const WAIT_MAX_SECONDS = 600;
+const WAIT_POLL_MS = 3000;
+/** Seconds `tool <name> --wait[=<seconds>]` may wait; 0 without it. */
+function waitSeconds(flags, name) {
+    const value = flags.wait;
+    if (value === undefined)
+        return 0;
+    if (name !== "get_setup_run")
+        throw new CliError("--wait works with get_setup_run only.", 2);
+    if (value === true)
+        return WAIT_SECONDS;
+    const seconds = Number(value);
+    if (!Number.isInteger(seconds) || seconds < 1 || seconds > WAIT_MAX_SECONDS) {
+        throw new CliError(`--wait takes whole seconds from 1 to ${WAIT_MAX_SECONDS}.`, 2);
+    }
+    return seconds;
+}
+function awaitingApproval(answer) {
+    const text = answer.content?.find((part) => part.type === "text")?.text;
+    try {
+        return JSON.parse(text ?? "").run?.status === "awaiting_approval";
+    }
+    catch {
+        return false;
+    }
+}
 async function openSession(ctx, flags) {
     const found = await findConfig(ctx.cwd);
     if (!found)

package/dist/index.js

@@ -16,6 +16,7 @@ Usage
   mapled connect [--project <id>]                    Connect this repository: sign in, write mapled.json, print the guide for AI agents
   mapled tools [--json]                               List the Mapled tools an agent can call
   mapled tool <name> [<json> | --input <file>]        Call one tool — the same ones the MCP server offers
+                                                      get_setup_run --wait[=<s>] waits (90 s by default) for the plan's approval
   mapled auth login [--api <origin>] [--no-browser]   Sign in to a project in your browser
   mapled auth logout [--all]                          Revoke this machine's access to the linked project
   mapled project link [--project <id>]                Write mapled.json for this repository

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapled/cli",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Mapled CLI — sign in, link a project, generate TypeScript types for its content, create forms, preview drafts and check the site's integration.",
   "license": "MIT",
   "homepage": "https://mapled.io",