@nomac/cli 0.20.0 → 0.21.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nomac/cli",
3
- "version": "0.20.0",
3
+ "version": "0.21.1",
4
4
  "description": "A real cloud Mac for AI agents: Xcode, the iOS Simulator, signing, TestFlight and App Store publishing, by the minute, over MCP, SSH and HTTPS.",
5
5
  "license": "UNLICENSED",
6
6
  "type": "module",
package/skill/SKILL.md CHANGED
@@ -47,7 +47,8 @@ Store screenshots start the phone with `device: "iphone-pro-max"` (6.9-inch,
47
47
  Run commands with `nomac exec -- COMMAND`: it prints the output as it
48
48
  arrives and exits with the command's code, waiting at most 30 s (or the
49
49
  `--timeout` given, up to 600 s). For builds and tests use
50
- `nomac exec --wait 600 -- COMMAND`. Exit code 75 means still running: wait
50
+ `nomac exec --wait 600 -- COMMAND`. What is piped in is the command's stdin
51
+ (`cat build.sh | nomac exec -- bash -s`). Exit code 75 means still running: wait
51
52
  with `nomac job JOB_ID --wait 600`, never rerun. In scripts add
52
53
  `--request-key stable-key-0001`. A command may run an hour (`--timeout
53
54
  3600`); longer, use `nomac ssh -- COMMAND`. A command ends with everything
@@ -104,14 +105,20 @@ keyboard and mouse, also on the lock screen and in password dialogs, use
104
105
  `mac_input`): each answers with a screenshot. Drive the Simulator with
105
106
  simulator-use, preinstalled: `simulator-use look` reads the screen as text,
106
107
  `simulator-use act 'tap "Sign In"'` taps and types by label, `simulator-use run`
107
- builds, installs and launches (simctl works too). Give the human
108
+ builds, installs and launches (simctl works too), `simulator-use app launch ID
109
+ -Onboarding 3` opens a screen with launch arguments (UserDefaults) and
110
+ `simulator-use look --out shot.jpg` saves it once still (`.png`: full size),
111
+ and `simulator-use app storekit Products.storekit --app ID` tests in-app
112
+ purchases from the app's `.storekit` file (the App Store's sandbox cannot buy
113
+ in a Simulator). Give the human
108
114
  `open_mac_desktop` when they want to see the screen.
109
115
  `get_mac_session` (and `nomac status --json`) lists what
110
116
  is installed: Node, Python, uv, nvm, Ruby with CocoaPods, xcbeautify, xcodegen,
111
117
  gh, Git LFS, jq and simulator-use.
112
118
  Pipe xcodebuild through `xcbeautify`. Simulator devices share names across iOS
113
119
  runtimes: pick one by ID (`xcrun simctl list devices available`) or with
114
- `OS=27.0` in `-destination`. Apple Intelligence cannot generate on a virtual
120
+ `OS=27.0` in `-destination`; an older iOS downloads in about 6 minutes
121
+ (`xcodebuild -downloadPlatform iOS -buildVersion 26.5`). Apple Intelligence cannot generate on a virtual
115
122
  Mac, in the Simulator either: test it on a device.
116
123
  Report failures using `report_issue` with `session_id`, optional `job_id` and
117
124
  a description without secrets. Read https://nomac.app/llms.txt for full limits.
@@ -60,7 +60,8 @@ const HELP = `Nomac cloud Mac sessions
60
60
  grant permissions on this Mac at start
61
61
  nomac exec [--wait 30] -- command args
62
62
  runs it, prints its output as it arrives,
63
- exits with its code.
63
+ exits with its code. What is piped in is its
64
+ stdin (cat build.sh | nomac exec -- bash -s).
64
65
  Waits up to 30 s, or with --timeout N up to N s
65
66
  (at most 600); for builds and tests use --wait 600.
66
67
  Exit code 75 means still running: see nomac job.
@@ -189,6 +190,40 @@ export async function sessionAccess(id, request = api) {
189
190
  transportOptions({ gateway: access.gateway, token: access.token });
190
191
  return access;
191
192
  }
193
+ /** A command's whole request, what it reads on stdin included: the gateway takes 64 KiB. */
194
+ const JOB_BYTES = 63 * 1024;
195
+ /**
196
+ * What is piped into nomac exec (cat build.sh | nomac exec -- bash -s, or < build.sh), for the command on the Mac.
197
+ * A terminal, /dev/null, and a pipe that sends nothing in its first second (an agent's shell that keeps stdin open
198
+ * and never writes) give nothing, so a command never waits for input nobody sends. More than fits in a command is
199
+ * refused, never cut.
200
+ */
201
+ export function pipedInput(input = process.stdin, { firstByteMs = 1000, limit = JOB_BYTES } = {}) {
202
+ if (!input || input.isTTY) return Promise.resolve(null);
203
+ return new Promise((resolve, reject) => {
204
+ const chunks = []; let size = 0, done = false;
205
+ const finish = (error, value) => {
206
+ if (done) return; done = true; clearTimeout(silent);
207
+ input.off("data", onData); input.off("end", onEnd); input.off("error", onEnd);
208
+ // Nothing else reads stdin: let go of it, so a pipe that never ends cannot keep this process alive.
209
+ if (error || value === null) input.destroy?.(); else input.pause?.();
210
+ if (error) reject(error); else resolve(value);
211
+ };
212
+ const onData = chunk => {
213
+ size += chunk.length;
214
+ if (size > limit) finish(new CliError(`What is piped into nomac exec goes with the command, which can be ${limit / 1024} KiB in all; this is more. Copy a larger file to the Mac (nomac sync, then run it there).`));
215
+ else chunks.push(chunk);
216
+ };
217
+ const onEnd = () => finish(null, size ? Buffer.concat(chunks) : null);
218
+ const silent = setTimeout(() => { if (!size) finish(null, null); }, firstByteMs);
219
+ silent.unref?.();
220
+ input.on("data", onData); input.on("end", onEnd); input.on("error", onEnd);
221
+ });
222
+ }
223
+ /** The command on the Mac reading input on its stdin: carried in the request as base64, decoded into a pipe. */
224
+ export function withInput(command, input) {
225
+ return ["/bin/bash", "-c", 'data=$1; shift; printf %s "$data" | /usr/bin/base64 -D | "$@"', "nomac-stdin", input.toString("base64"), ...command];
226
+ }
192
227
  /** nomac exec's exit code for a command still running when the wait ends (EX_TEMPFAIL). */
193
228
  export const STILL_RUNNING = 75;
194
229
  /** Quick commands are checked early; after that, once a second. */
@@ -365,7 +400,7 @@ export async function hostedRequest(id, method, path, params = {}, { request = a
365
400
  return transport(method, path, { ...params, gateway: access.gateway, token: access.token });
366
401
  }
367
402
  export async function hostedSessionCommand(command, argv, { store = sessionStore(), request = api, transport = macRequest, run = runProcess, print = console.log, sleep = ms => new Promise(r => setTimeout(r, ms)), now = Date.now,
368
- stdout = data => process.stdout.write(data), stderr = data => process.stderr.write(data), exitWith = code => { process.exitCode = code; } , watch = watchFolder, stopWatching = undefined, debounceMs = 600} = {}) {
403
+ stdout = data => process.stdout.write(data), stderr = data => process.stderr.write(data), exitWith = code => { process.exitCode = code; } , watch = watchFolder, stopWatching = undefined, debounceMs = 600, readInput = pipedInput} = {}) {
369
404
  let parsed;
370
405
  try { parsed = parseArgs({ args: argv, options, allowPositionals: true }); }
371
406
  catch (error) { throw new CliError(error.message); }
@@ -568,9 +603,13 @@ export async function hostedSessionCommand(command, argv, { store = sessionStore
568
603
  const waitFor = waitSeconds = integer(values.wait, given === null ? 30 : Math.min(given, 600), 0, 3600);
569
604
  const timeout = given ?? (values["request-key"] === undefined ? Math.max(300, waitFor) : 600);
570
605
  const line = isShellLine(positionals), dir = local.workspaceOnDrive ? local.workspace : null;
571
- const remote = dir ? (line ? ["/bin/bash", "-lc", `cd ${shellQuote(dir)} && ${positionals[0]}`] : ["/bin/bash", "-lc", `cd ${shellQuote(dir)} && exec "$@"`, "nomac", ...positionals])
606
+ const onMac = dir ? (line ? ["/bin/bash", "-lc", `cd ${shellQuote(dir)} && ${positionals[0]}`] : ["/bin/bash", "-lc", `cd ${shellQuote(dir)} && exec "$@"`, "nomac", ...positionals])
572
607
  : line ? ["/bin/bash", "-lc", positionals[0]] : positionals;
608
+ const input = await readInput();
609
+ const remote = input?.length ? withInput(onMac, input) : onMac;
573
610
  method = "POST"; path = `${base}/jobs`; params = { requestKey: values["request-key"] ?? `cli-${randomUUID()}`, body: { argv: remote, timeout_seconds: timeout } };
611
+ const size = Buffer.byteLength(JSON.stringify(params.body));
612
+ if (input?.length && size > JOB_BYTES) throw new CliError(`What is piped into nomac exec goes with the command, which can be ${JOB_BYTES / 1024} KiB in all; this is ${Math.ceil(size / 1024)} KiB. Copy a larger file to the Mac (nomac sync, then run it there).`);
574
613
  } else {
575
614
  if (positionals.length !== 1 || !/^job_[a-f0-9]{40}$/.test(positionals[0])) throw new CliError("Supply the existing job ID.");
576
615
  path = `${base}/jobs/${positionals[0]}`;
package/src/mcp.mjs CHANGED
@@ -22,7 +22,7 @@ const INSTRUCTIONS = [
22
22
  "Use it when work needs macOS this machine lacks (Windows, Linux, a cloud sandbox): an iOS, iPadOS, watchOS, visionOS or macOS app (Swift, SwiftUI, React Native, Expo, Flutter, Capacitor), Xcode, signing, TestFlight or the App Store.",
23
23
  "Typical flow: get_mac_credits, start_mac, poll get_mac_session until ready, put code there (exec_mac with git clone into ~/drive/src, write_mac_file, fetch_to_mac, create_mac_upload_link), run exec_mac, get results with read_mac_file or create_mac_download_link, then stop_mac.",
24
24
  "The account's drive at ~/drive (20 GB) is on every Mac and kept between sessions; everything outside it is deleted at stop. Clone and build in ~/drive/src/<repo> so the next session rebuilds only what changed; keep it under 10 GB (nomac-drive shows what takes the space, nomac-drive clean deletes stale build products).",
25
- "The Mac's own Simulator: simulator-use is on it (run it with exec_mac): simulator-use look reads the screen as text, simulator-use act 'tap \"Sign In\"' taps by label, simulator-use run builds and launches the app; ~/NOMAC.md has the rest.",
25
+ "The Mac's own Simulator: simulator-use is on it (run it with exec_mac): simulator-use look reads the screen as text, simulator-use act 'tap \"Sign In\"' taps by label, simulator-use run builds and launches it, app storekit tests purchases; ~/NOMAC.md has the rest.",
26
26
  "When an answer says low_credit (under an hour left), tell the human before a long build and offer its buy_url: a Mac stops when the credit runs out. For a refill, suggest 3 packs ($30, +5%).",
27
27
  "One Mac per account at a time: start_mac while one runs answers session_limit_reached with its id, to use; parallel: true starts a second (accounts that bought credit, while NoMac has one to spare), without the drive.",
28
28
  "exec_mac returns a quick command's output in the same call; pass wait_seconds: 40 for builds and tests (a call answers within 45 s). A command still running comes back as a job: poll get_mac_job with its job_id, then read_mac_output.",
@@ -222,7 +222,7 @@
222
222
  },
223
223
  {
224
224
  "name": "phone_app_control",
225
- "description": "Cloud iPhone: Launch, install, stop or remove an app on the Simulator; open a URL or deep link; grant, revoke or reset a permission; set the location; send a push; set the phone's appearance, locale, time zone, text size or a clean status bar. launch answers with the app's first screen; later calls default to the app launched last.",
225
+ "description": "Cloud iPhone: Launch, install, stop or remove an app; open a URL or deep link; grant, revoke or reset permissions; set location; send a push; test purchases (.storekit); set appearance, locale, time zone, text size or a clean status bar. launch answers with its first screen.",
226
226
  "inputSchema": {
227
227
  "type": "object",
228
228
  "properties": {
@@ -239,6 +239,7 @@
239
239
  "reset_permissions",
240
240
  "location",
241
241
  "push",
242
+ "storekit",
242
243
  "appearance",
243
244
  "locale",
244
245
  "timezone",
@@ -248,11 +249,11 @@
248
249
  "description": "What to do"
249
250
  },
250
251
  "app": {
251
- "description": "Bundle id, or for install the path to a Simulator .app",
252
+ "description": "Bundle id (default: last launched); install: a Simulator .app path",
252
253
  "type": "string"
253
254
  },
254
255
  "value": {
255
- "description": "URL, permission, lat,long, push text/JSON, light/dark, locale (fr_FR), time zone (Europe/Paris), text size or clean/clear, per action",
256
+ "description": "Per action: URL, permission, lat,long, push text/JSON, launch args (-Key value; no secrets), light/dark, locale (fr_FR), time zone (Europe/Paris), text size, clean/clear",
256
257
  "type": "string"
257
258
  },
258
259
  "device": {