gipity 1.0.356 → 1.0.374

package/dist/commands/domain.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { get, post, del } from '../api.js';
 import { getConfig, requireConfig } from '../config.js';
-import { error as clrError, success, muted } from '../colors.js';
+import { error as clrError, success, muted, brand } from '../colors.js';
 import { run, printList } from '../helpers/index.js';
 export const domainCommand = new Command('domain')
     .description('Manage custom domains')
@@ -21,7 +21,7 @@ export const domainCommand = new Command('domain')
                     console.log(JSON.stringify(res.data));
                     return;
                 }
-                console.log(`Domains: ${count}/${limit}\n`);
+                console.log(`${muted('Domains:')} ${brand(`${count}/${limit}`)}\n`);
                 if (domains.length === 0) {
                     console.log('No custom domains.');
                     return;
@@ -34,18 +34,21 @@ export const domainCommand = new Command('domain')
                         grouped.set(key, []);
                     grouped.get(key).push(d);
                 }
+                let first = true;
                 for (const [label, doms] of grouped) {
-                    console.log(label);
+                    if (!first)
+                        console.log('');
+                    first = false;
+                    console.log(brand(label));
                     for (const d of doms) {
-                        console.log(`  ${d.domain}  ${muted(d.status)}  ${muted(`[${d.shortGuid}]`)}`);
+                        console.log(`${d.domain}  ${muted(d.status)}  ${muted(`[${d.shortGuid}]`)}`);
                     }
-                    console.log();
                 }
             }
             else {
                 const config = requireConfig();
                 const res = await get(`/projects/${config.projectGuid}/domains`);
-                printList(res.data, opts, 'No custom domains configured.', d => `  ${d.domain}  ${muted(d.status)}  ${muted(`[${d.short_guid}]`)}`);
+                printList(res.data, opts, 'No custom domains configured.', d => `${d.domain}  ${muted(d.status)}  ${muted(`[${d.short_guid}]`)}`);
             }
             break;
         }
@@ -64,15 +67,15 @@ export const domainCommand = new Command('domain')
                 console.log(success(`Domain "${data.domain.domain}" added.`));
                 console.log('');
                 console.log('Add this DNS record:');
-                console.log(`  Type:   ${data.instructions.type}`);
-                console.log(`  Name:   ${data.instructions.name}`);
-                console.log(`  Target: ${data.instructions.target}`);
+                console.log(`${muted('Type:'.padEnd(8))}${data.instructions.type}`);
+                console.log(`${muted('Name:'.padEnd(8))}${data.instructions.name}`);
+                console.log(`${muted('Target:'.padEnd(8))}${data.instructions.target}`);
                 if (data.instructions.note) {
                     console.log('');
                     console.log(data.instructions.note);
                 }
                 console.log('');
-                console.log(`Then run: gipity domain verify ${data.domain.short_guid}`);
+                console.log(muted(`Then run: gipity domain verify ${data.domain.short_guid}`));
             }
             break;
         }
@@ -121,11 +124,11 @@ export const domainCommand = new Command('domain')
         default:
             console.log('Usage: gipity domain [list|add|verify|remove]');
             console.log('');
-            console.log('  gipity domain list              List project domains');
-            console.log('  gipity domain list --all        List all domains across projects');
-            console.log('  gipity domain add <domain.com>  Add a custom domain (requires project)');
-            console.log('  gipity domain verify <guid>     Verify DNS and activate (requires project)');
-            console.log('  gipity domain remove <guid>     Remove a custom domain');
+            console.log(`${brand('gipity domain list')}              ${muted('List project domains')}`);
+            console.log(`${brand('gipity domain list --all')}        ${muted('List all domains across projects')}`);
+            console.log(`${brand('gipity domain add <domain.com>')}  ${muted('Add a custom domain (requires project)')}`);
+            console.log(`${brand('gipity domain verify <guid>')}     ${muted('Verify DNS and activate (requires project)')}`);
+            console.log(`${brand('gipity domain remove <guid>')}     ${muted('Remove a custom domain')}`);
     }
 }));
 //# sourceMappingURL=domain.js.map

package/dist/commands/email.js

@@ -41,15 +41,11 @@ export const emailCommand = new Command('email')
             const recap = res.data.to.join(', ')
                 + (res.data.cc.length ? `, cc: ${res.data.cc.join(', ')}` : '')
                 + (res.data.bcc.length ? `, bcc: ${res.data.bcc.length}` : '');
-            console.log('');
             console.log(success(`Email sent to ${recap}: ${res.data.subject}`));
-            console.log('');
         }
     }
     catch (err) {
-        console.log('');
         console.error(clrError(`Email failed: ${err.message}`));
-        console.log('');
         process.exit(1);
     }
 });

package/dist/commands/fn.js

@@ -14,7 +14,7 @@ fnCommand
     const res = await get(`/projects/${config.projectGuid}/functions`);
     printList(res.data, opts, 'No functions defined.', f => {
         const line = `${bold(f.name)}  ${muted(`v${f.version}`)}  ${muted(f.auth_level)}  ${muted(`timeout=${f.timeout_ms}ms`)}`;
-        return f.description ? `${line}\n  ${muted(f.description)}` : line;
+        return f.description ? `${line}\n${muted(f.description)}` : line;
     });
 }));
 fnCommand
@@ -30,7 +30,7 @@ fnCommand
         const ts = new Date(log.created_at).toLocaleString();
         const statusColor = log.status === 'success' ? success : log.status === 'error' ? clrError : muted;
         const line = `${statusColor(log.status)}  ${dur}  ${muted(log.trigger_type || 'http')}  ${muted(ts)}`;
-        return log.error_message ? `${line}\n  ${clrError(`error: ${log.error_message}`)}` : line;
+        return log.error_message ? `${line}\n${clrError(`error: ${log.error_message}`)}` : line;
     });
 }));
 fnCommand

package/dist/commands/generate.js

@@ -2,15 +2,18 @@ import { Command } from 'commander';
 import { post } from '../api.js';
 import { resolveProjectContext } from '../config.js';
 import { writeFileSync } from 'fs';
+import { resolve as resolvePath } from 'path';
 import { error as clrError, success, muted, info } from '../colors.js';
 import { IMAGE_MODELS_DOC, IMAGE_GEMINI_ASPECT_RATIOS, IMAGE_GEMINI_SIZES, VIDEO_MODELS_DOC, TTS_PROVIDER_DESCRIPTIONS } from '../provider-docs.js';
-/** Download a URL and save to a local file */
+/** Download a URL and save to a local file. Returns the absolute path written,
+ *  so callers can report exactly where the file landed. */
 async function downloadFile(url, filename) {
     const res = await fetch(url);
     if (!res.ok)
         throw new Error(`Download failed: ${res.status}`);
     const buffer = Buffer.from(await res.arrayBuffer());
     writeFileSync(filename, buffer);
+    return resolvePath(filename);
 }
 // ── IMAGE ──────────────────────────────────────────────────────────────
 const imageCommand = new Command('image')
@@ -25,16 +28,16 @@ Gemini-specific options:
 Examples:
   gipity generate image "a cat wearing a top hat"
   gipity generate image "landscape sunset" --provider gemini --aspect-ratio 16:9 --image-size 2K
-  gipity generate image "product photo" --provider openai --model gpt-image-1 --size 1536x1024 --quality high
+  gipity generate image "product photo" --provider openai --model gpt-image-2 --size 1536x1024 --quality high
   gipity generate image "abstract art" --provider bfl --model flux-2-pro -o art.png`)
     .argument('<prompt>', 'Text description of the image to generate')
     .option('--provider <provider>', 'Image provider: openai, bfl, or gemini (default: bfl)')
     .option('--model <model>', 'Model ID (see provider list above)')
     .option('--size <size>', 'Dimensions as WxH, e.g. "1024x1024" (OpenAI/BFL)')
-    .option('--quality <quality>', 'Quality: low|medium|high|auto (gpt-image-1), standard|hd (dall-e-3)')
+    .option('--quality <quality>', 'Quality: low|medium|high|auto (gpt-image-2)')
     .option('--aspect-ratio <ratio>', 'Aspect ratio (Gemini only): 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 4:5, 5:4, 21:9')
     .option('--image-size <size>', 'Output resolution (Gemini only): 512, 1K, 2K, 4K')
-    .option('-o, --output <file>', 'Output filename (default: generated.png)')
+    .option('-o, --output <file>', 'Output path (default ./generated.png). For an image your app ships, write it into the source tree so it deploys, e.g. -o src/assets/images/hero.png; the cwd default is fine for one-off generation.')
     .option('--json', 'Output as JSON')
     .action(async (prompt, opts) => {
     try {
@@ -50,14 +53,14 @@ Examples:
         });
         const ext = result.content_type.includes('png') ? 'png' : 'jpg';
         const filename = opts.output || `generated.${ext}`;
-        await downloadFile(result.url, filename);
+        const savedPath = await downloadFile(result.url, filename);
         if (opts.json) {
-            console.log(JSON.stringify({ ...result, saved: filename }));
+            console.log(JSON.stringify({ ...result, saved: savedPath }));
         }
         else {
             const sizeKb = Math.round(result.size_bytes / 1024);
             console.log(`${muted(`Generated with ${result.provider}/${result.model} (${sizeKb}KB)`)}`);
-            console.log(success(`Saved to ${filename}`));
+            console.log(success(`Saved to ${savedPath}`));
         }
     }
     catch (err) {
@@ -88,12 +91,13 @@ Examples:
     .option('--model <model>', 'Veo model: veo-3.1-generate-preview (quality), veo-3.1-fast-generate-preview (speed), veo-3.1-lite-generate-preview (budget)')
     .option('--aspect <ratio>', 'Aspect ratio: 16:9 (landscape), 9:16 (portrait), 1:1 (square)')
     .option('--resolution <res>', 'Video resolution: 720p, 1080p, 4k')
-    .option('-o, --output <file>', 'Output filename (default: generated.mp4)')
+    .option('-o, --output <file>', 'Output path (default ./generated.mp4). For a clip your app ships, write it into the source tree so it deploys, e.g. -o src/assets/video/clip.mp4; the cwd default is fine for one-off generation.')
     .option('--json', 'Output as JSON')
     .action(async (prompt, opts) => {
     try {
         const { config } = await resolveProjectContext();
-        console.log(info('Generating video (this may take 30-120 seconds)...'));
+        if (!opts.json)
+            console.log(info('Generating video (this may take 30-120 seconds)...')); // keep --json stdout pure JSON
         const result = await post(`/projects/${config.projectGuid}/generate/video`, {
             prompt,
             model: opts.model,
@@ -101,14 +105,14 @@ Examples:
             resolution: opts.resolution,
         });
         const filename = opts.output || 'generated.mp4';
-        await downloadFile(result.url, filename);
+        const savedPath = await downloadFile(result.url, filename);
         if (opts.json) {
-            console.log(JSON.stringify({ ...result, saved: filename }));
+            console.log(JSON.stringify({ ...result, saved: savedPath }));
         }
         else {
             const sizeKb = Math.round(result.size_bytes / 1024);
             console.log(`${muted(`Generated with ${result.provider}/${result.model} (${sizeKb}KB)`)}`);
-            console.log(success(`Saved to ${filename}`));
+            console.log(success(`Saved to ${savedPath}`));
         }
     }
     catch (err) {
@@ -137,7 +141,7 @@ Examples:
     .option('--voice <voice>', 'Voice ID or name (provider-specific)')
     .option('--language <code>', 'BCP-47 language code, e.g. ja-JP, es-ES (Gemini only, 60+ languages)')
     .option('--speakers <json>', 'Multi-speaker config as JSON array (Gemini only, up to 2 speakers)')
-    .option('-o, --output <file>', 'Output filename (default: speech.mp3)')
+    .option('-o, --output <file>', 'Output path (default ./speech.mp3). For audio your app ships, write it into the source tree so it deploys, e.g. -o src/assets/sounds/intro.mp3; the cwd default is fine for one-off generation.')
     .option('--json', 'Output as JSON')
     .action(async (text, opts) => {
     try {
@@ -160,14 +164,14 @@ Examples:
             speakers,
         });
         const filename = opts.output || 'speech.mp3';
-        await downloadFile(result.url, filename);
+        const savedPath = await downloadFile(result.url, filename);
         if (opts.json) {
-            console.log(JSON.stringify({ ...result, saved: filename }));
+            console.log(JSON.stringify({ ...result, saved: savedPath }));
         }
         else {
             const sizeKb = Math.round(result.size_bytes / 1024);
             console.log(`${muted(`Generated with ${result.provider} (${sizeKb}KB)`)}`);
-            console.log(success(`Saved to ${filename}`));
+            console.log(success(`Saved to ${savedPath}`));
         }
     }
     catch (err) {
@@ -175,10 +179,61 @@ Examples:
         process.exit(1);
     }
 });
+// ── MUSIC ──────────────────────────────────────────────────────────────
+const musicCommand = new Command('music')
+    .description(`Generate music from a text prompt using AI.
+
+The model is chosen from the platform's music catalog. Omit --model to use the
+default; pass --model <id> only if you want a specific one (see the catalog with
+\`gipity service call music/models --get\`).
+
+Tips:
+  - Describe genre, mood, instruments, and tempo (e.g. "upbeat lo-fi hip hop with mellow piano")
+  - Music is instrumental by default; pass --vocals to allow singing
+  - Longer clips cost more; the max length depends on the model
+
+Examples:
+  gipity generate music "chill lo-fi beat for studying"
+  gipity generate music "epic orchestral battle theme" --duration 60 -o src/assets/audio/theme.mp3
+  gipity generate music "indie pop chorus" --vocals --duration 20`)
+    .argument('<prompt>', 'Text description of the music to generate')
+    .option('--duration <seconds>', 'Clip length in seconds (default 30; max depends on the model)', (v) => parseInt(v, 10))
+    .option('--model <model>', 'Music model id (default: platform default)')
+    .option('--vocals', 'Allow vocals (default: instrumental only)')
+    .option('-o, --output <file>', 'Output path (default ./music.mp3). For audio your app ships, write it into the source tree so it deploys, e.g. -o src/assets/audio/theme.mp3; the cwd default is fine for one-off generation.')
+    .option('--json', 'Output as JSON')
+    .action(async (prompt, opts) => {
+    try {
+        const { config } = await resolveProjectContext();
+        if (!opts.json)
+            console.log(info('Generating music...')); // keep --json stdout pure JSON
+        const result = await post(`/projects/${config.projectGuid}/generate/music`, {
+            prompt,
+            duration_seconds: opts.duration,
+            model: opts.model,
+            instrumental: !opts.vocals,
+        });
+        const filename = opts.output || 'music.mp3';
+        const savedPath = await downloadFile(result.url, filename);
+        if (opts.json) {
+            console.log(JSON.stringify({ ...result, saved: savedPath }));
+        }
+        else {
+            const sizeKb = Math.round(result.size_bytes / 1024);
+            console.log(`${muted(`Generated with ${result.model} (${sizeKb}KB)`)}`);
+            console.log(success(`Saved to ${savedPath}`));
+        }
+    }
+    catch (err) {
+        console.error(clrError(`Music generation failed: ${err.message}`));
+        process.exit(1);
+    }
+});
 // ── PARENT COMMAND ─────────────────────────────────────────────────────
 export const generateCommand = new Command('generate')
-    .description('Generate images, video, or speech')
+    .description('Generate images, video, speech, or music')
     .addCommand(imageCommand)
     .addCommand(videoCommand)
-    .addCommand(speechCommand);
+    .addCommand(speechCommand)
+    .addCommand(musicCommand);
 //# sourceMappingURL=generate.js.map

package/dist/commands/job.js

@@ -17,7 +17,7 @@ jobCommand
         if (j.on_complete)
             tags.push(muted(`→ ${j.on_complete}`));
         const line = `${bold(j.name)}  ${tags.join('  ')}`;
-        return j.description ? `${line}\n  ${muted(j.description)}` : line;
+        return j.description ? `${line}\n${muted(j.description)}` : line;
     });
 }));
 jobCommand
@@ -57,13 +57,13 @@ jobCommand
     const statusColor = r.status === 'success' ? success : r.status === 'failed' ? clrError : muted;
     console.log(`${statusColor(r.status)}  ${muted(r.guid)}`);
     if (r.progress_pct != null)
-        console.log(`  progress: ${Math.round(r.progress_pct * 100)}%${r.progress_message ? ` (${r.progress_message})` : ''}`);
+        console.log(`progress: ${Math.round(r.progress_pct * 100)}%${r.progress_message ? ` (${r.progress_message})` : ''}`);
     if (r.duration_ms != null)
-        console.log(`  duration: ${r.duration_ms}ms`);
+        console.log(`duration: ${r.duration_ms}ms`);
     if (r.error)
-        console.log(`  ${clrError('error:')} ${r.error}`);
+        console.log(`${clrError('error:')} ${r.error}`);
     if (r.output)
-        console.log(`  output: ${JSON.stringify(r.output)}`);
+        console.log(`output: ${JSON.stringify(r.output)}`);
 }));
 jobCommand
     .command('runs <name>')
@@ -78,7 +78,7 @@ jobCommand
         const dur = r.duration_ms != null ? `${r.duration_ms}ms` : '?';
         const ts = new Date(r.created_at).toLocaleString();
         const line = `${statusColor(r.status)}  ${dur}  ${muted(r.trigger_type)}  ${muted(r.guid)}  ${muted(ts)}`;
-        return r.error ? `${line}\n  ${clrError(`error: ${r.error}`)}` : line;
+        return r.error ? `${line}\n${clrError(`error: ${r.error}`)}` : line;
     });
 }));
 jobCommand

package/dist/commands/location.js

@@ -12,16 +12,16 @@ function formatLocation(r) {
     const lines = [];
     const place = [r.city, r.region, r.country].filter(Boolean).join(', ');
     if (place)
-        lines.push(`  ${place}`);
+        lines.push(place);
     if (r.lat != null && r.lon != null)
-        lines.push(`  Coordinates: ${r.lat}, ${r.lon}`);
+        lines.push(`Coordinates: ${r.lat}, ${r.lon}`);
     if (r.ip)
-        lines.push(`  IP:          ${r.ip}`);
+        lines.push(`IP:          ${r.ip}`);
     if (r.timezone)
-        lines.push(`  Timezone:    ${r.timezone}`);
+        lines.push(`Timezone:    ${r.timezone}`);
     if (r.accuracy != null)
-        lines.push(`  Accuracy:    ${Math.round(r.accuracy)}m`);
-    lines.push(`  Source:      ${r.source}`);
+        lines.push(`Accuracy:    ${Math.round(r.accuracy)}m`);
+    lines.push(`Source:      ${r.source}`);
     return lines.join('\n');
 }
 /**
@@ -71,7 +71,7 @@ export const locationCommand = new Command('location')
         return;
     }
     if (!res.data) {
-        console.log('  No location data.');
+        console.log('No location data.');
         return;
     }
     console.log(formatLocation(res.data));

package/dist/commands/login.js

@@ -2,7 +2,7 @@ import { Command } from 'commander';
 import { saveAuth, getAuth } from '../auth.js';
 import { publicPost } from '../api.js';
 import { prompt, decodeJwtExp } from '../utils.js';
-import { success, error as clrError } from '../colors.js';
+import { success, error as clrError, muted } from '../colors.js';
 export const loginCommand = new Command('login')
     .description('Log in or sign up')
     .option('--email <email>', 'Email address')
@@ -19,37 +19,27 @@ export const loginCommand = new Command('login')
         // Email only → send code and exit (non-interactive step 1)
         if (email && !code) {
             await publicPost('/auth/login', { email });
-            console.log('');
             console.log('Check your email for a 6-digit code.');
-            console.log(`Then run: gipity login --email ${email} --code <code>`);
-            console.log('');
+            console.log(muted(`Then run: gipity login --email ${email} --code <code>`));
             return;
         }
         // Fully interactive flow
-        console.log('');
         console.log('Enter your email to log in or create an account.');
-        console.log('');
         const existing = getAuth();
         email = await prompt(existing ? `Email [${existing.email}]: ` : 'Email: ');
         if (!email && existing)
             email = existing.email;
         if (!email) {
-            console.log('');
             console.error(clrError('Email required.'));
-            console.log('');
             process.exit(1);
         }
         await publicPost('/auth/login', { email });
-        console.log('');
         console.log('Check your email for a 6-digit code.');
-        console.log('');
         code = await prompt('Code: ');
         await verify(email, code);
     }
     catch (err) {
-        console.log('');
         console.error(clrError(`Login failed: ${err.message}`));
-        console.log('');
         process.exit(1);
     }
 });
@@ -57,9 +47,7 @@ async function verify(email, code) {
     const res = await publicPost('/auth/verify', { email, code });
     const exp = decodeJwtExp(res.accessToken);
     if (!exp) {
-        console.log('');
         console.error(clrError('Invalid token received.'));
-        console.log('');
         process.exit(1);
     }
     const expiresAt = new Date(exp * 1000).toISOString();
@@ -69,8 +57,6 @@ async function verify(email, code) {
         email,
         expiresAt,
     });
-    console.log('');
     console.log(success(`Logged in (${email}).`));
-    console.log('');
 }
 //# sourceMappingURL=login.js.map

package/dist/commands/logout.js

@@ -1,17 +1,16 @@
 import { Command } from 'commander';
 import { getAuth, clearAuth } from '../auth.js';
+import { success } from '../colors.js';
 export const logoutCommand = new Command('logout')
     .description('Log out')
     .action(() => {
     const auth = getAuth();
-    console.log('');
     if (!auth) {
         console.log('Not logged in.');
     }
     else {
         clearAuth();
-        console.log(`Logged out (${auth.email}).`);
+        console.log(success(`Logged out (${auth.email}).`));
     }
-    console.log('');
 });
 //# sourceMappingURL=logout.js.map

package/dist/commands/logs.js

@@ -30,7 +30,7 @@ logsCommand
         const status = statusColor(log.status.padEnd(8));
         const trigger = muted(log.trigger_type.padEnd(8));
         const err = log.error_message ? `  ${clrError(`"${log.error_message}"`)}` : '';
-        console.log(`  ${muted(time)}  ${status} ${dur} ${trigger}${err}`);
+        console.log(`${muted(time)}  ${status} ${dur} ${trigger}${err}`);
     }
 }));
 logsCommand

package/dist/commands/page-eval.js

@@ -1,7 +1,38 @@
 import { Command } from 'commander';
-import { post } from '../api.js';
-import { brand, bold, muted } from '../colors.js';
+import { post, get, ApiError } from '../api.js';
+import { brand, bold, muted, warning } from '../colors.js';
 import { run } from '../helpers/index.js';
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** Poll the async eval job until it finishes. Eval runs server-side as a
+ *  short-lived job (so a long --wait can't trip the gateway idle timeout);
+ *  we submit, then poll the result out of the job store. */
+async function pollEvalResult(evalJobId, waitMs) {
+    // Generous client budget: the server work is bounded by --wait plus browser
+    // open/settle overhead; give it that plus headroom before giving up.
+    const deadline = Date.now() + waitMs + 60_000;
+    let missCount = 0;
+    while (Date.now() < deadline) {
+        let rec;
+        try {
+            rec = (await get(`/tools/browser/eval/${evalJobId}`)).data;
+        }
+        catch (err) {
+            // A 404 right after submit can happen if the record hasn't landed yet;
+            // tolerate a few, then treat a persistent 404 as the job being gone.
+            if (err instanceof ApiError && err.statusCode === 404 && missCount++ < 3) {
+                await sleep(500);
+                continue;
+            }
+            throw err;
+        }
+        if (rec.status === 'done')
+            return rec;
+        if (rec.status === 'error')
+            throw new ApiError(rec.httpStatus, rec.code, rec.reason);
+        await sleep(1000);
+    }
+    throw new ApiError(504, 'EVAL_TIMEOUT', 'Eval did not finish in time; narrow the expression or lower --wait');
+}
 // The long-tail escape hatch alongside `page inspect`'s fixed bundle: when the
 // curated metrics don't cover what you need (computed styles, element rects,
 // visibility, z-index stacks), eval an expression in page context and get the
@@ -11,21 +42,31 @@ export const pageEvalCommand = new Command('eval')
     .argument('<url>', 'URL to load')
     .argument('<expr>', 'JavaScript expression to evaluate in page context (result is JSON-serialized)')
     .option('--wait <ms>', 'Sleep this many ms after DOMContentLoaded before evaluating (lets late async work settle)', '500')
+    .option('--wait-for <selector>', 'Wait until this CSS selector appears before evaluating (deterministic; replaces --wait)')
+    .option('--wait-timeout <ms>', 'Max ms to wait for --wait-for before giving up', '5000')
     .option('--json', 'Output as JSON')
     .action((url, expr, opts) => run('Page eval', async () => {
     const parsedWait = parseInt(opts.wait, 10);
     const waitMs = Number.isFinite(parsedWait) && parsedWait >= 0 ? parsedWait : 500;
-    const res = await post('/tools/browser/eval', { url, expr, waitMs });
-    const d = res.data;
+    const parsedTimeout = parseInt(opts.waitTimeout, 10);
+    const waitForTimeoutMs = Number.isFinite(parsedTimeout) && parsedTimeout >= 0 ? parsedTimeout : 5000;
+    const kickoff = await post('/tools/browser/eval', {
+        url, expr, waitMs,
+        waitForSelector: opts.waitFor || undefined,
+        waitForTimeoutMs: opts.waitFor ? waitForTimeoutMs : undefined,
+    });
+    const d = await pollEvalResult(kickoff.data.evalJobId, waitMs);
     if (opts.json) {
         console.log(JSON.stringify(d));
         return;
     }
-    console.log(`\n${brand('Eval')} ${bold(d.url || url)}`);
-    console.log(`  ${muted('Expression:')} ${expr}`);
+    console.log(`${brand('Eval')} ${bold(d.url || url)}`);
+    if (d.navigationIncomplete) {
+        console.log(`${warning('⚠ Navigation incomplete:')} ${d.note || 'page did not reach full load'}`);
+    }
+    console.log(`${muted('Expression:')} ${expr}`);
     console.log(`\n${d.result || muted('(empty result)')}`);
     if (d.truncated)
         console.log(muted('\n(result truncated to fit context - narrow the expression for the full value)'));
-    console.log('');
 }));
 //# sourceMappingURL=page-eval.js.map