vibeview 0.7.0 → 0.8.0

package/dist/cli.js

@@ -1,4 +1,25 @@
 #!/usr/bin/env node
+import {
+  AGENT_COMMANDS,
+  buildCommand,
+  clearDevState,
+  dev,
+  killOwnedMetro,
+  readDevState,
+  readMetroState,
+  runAgentVerb
+} from "./chunk-NZ4G3JKV.js";
+import {
+  ApiClient,
+  EXIT_INFRA_ERROR,
+  EXIT_PASS,
+  EXIT_TEST_FAIL,
+  createSpinner,
+  loadConfig,
+  resolveAuth,
+  saveConfig,
+  uploadApp
+} from "./chunk-YD2X6TQV.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -7,225 +28,6 @@ import { Command } from "commander";
 // src/commands/run-suite.ts
 import chalk3 from "chalk";
 
-// src/lib/config.ts
-import { readFileSync, writeFileSync, mkdirSync } from "fs";
-import { join } from "path";
-import { homedir } from "os";
-var CONFIG_DIR = join(homedir(), ".vibeview");
-var CONFIG_FILE = join(CONFIG_DIR, "config.json");
-function loadConfig() {
-  try {
-    return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
-  } catch {
-    return {};
-  }
-}
-function saveConfig(config) {
-  mkdirSync(CONFIG_DIR, { recursive: true });
-  writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + "\n", { mode: 384 });
-}
-
-// src/lib/auth.ts
-function resolveAuth(options) {
-  const token = options.token || process.env.VIBEVIEW_API_TOKEN || loadConfig().token;
-  if (!token) {
-    console.error("Error: No API token found.");
-    console.error(
-      "Set VIBEVIEW_API_TOKEN environment variable, use --token flag, or run: vibeview login"
-    );
-    process.exit(2);
-  }
-  const baseUrl = options.baseUrl || process.env.VIBEVIEW_BASE_URL || loadConfig().baseUrl || "https://vibeview.io";
-  return { token, baseUrl };
-}
-
-// src/lib/api-client.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { basename } from "path";
-var ApiClient = class {
-  constructor(baseUrl, token) {
-    this.baseUrl = baseUrl;
-    this.token = token;
-  }
-  async request(method, path, body) {
-    const url = `${this.baseUrl}/api/v1/ci${path}`;
-    const headers = {
-      Authorization: `Bearer ${this.token}`,
-      "Content-Type": "application/json"
-    };
-    const resp = await fetch(url, {
-      method,
-      headers,
-      body: body ? JSON.stringify(body) : void 0
-    });
-    if (!resp.ok) {
-      const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
-      if (resp.status === 404) throw new Error(`Not found: ${path}`);
-      throw new Error(`API error ${resp.status}: ${text}`);
-    }
-    return resp.json();
-  }
-  async listSuites(opts) {
-    const params = new URLSearchParams();
-    if (opts?.tags && opts.tags.length > 0) params.set("tags", opts.tags.join(","));
-    if (opts?.match) params.set("match", opts.match);
-    const qs = params.toString();
-    return this.request("GET", `/list-suites${qs ? `?${qs}` : ""}`);
-  }
-  async runSuite(suiteId, options) {
-    return this.request("POST", "/run-suite", {
-      suite_id: suiteId,
-      commit_sha: options?.commitSha,
-      model: options?.model,
-      provider: options?.provider,
-      mode: options?.mode,
-      // When pinning a specific device, omit device_category — the backend
-      // rejects the combo.
-      device_category: options?.device ? void 0 : options?.deviceCategory ?? "phone",
-      device_id: options?.device,
-      build_id: options?.build,
-      metadata: options?.metadata
-    });
-  }
-  async runTest(testId, options) {
-    return this.request("POST", "/run-test", {
-      test_id: testId,
-      commit_sha: options?.commitSha,
-      model: options?.model,
-      provider: options?.provider,
-      mode: options?.mode,
-      device_category: options?.device ? void 0 : options?.deviceCategory ?? "phone",
-      device_id: options?.device,
-      build_id: options?.build,
-      metadata: options?.metadata
-    });
-  }
-  /** Cancel a still-queued CI run by its queue entry id. Idempotent best-effort. */
-  async cancelQueueEntry(queueEntryId) {
-    await this.request("DELETE", `/queue/${queueEntryId}`);
-  }
-  /**
-   * Request cancellation of a still-running multi-suite run.
-   * The aggregate transitions to CANCELLED on the runner's next
-   * aggregate-status write; the active child suite stops at its
-   * next case boundary.
-   */
-  async cancelMultiSuiteRun(aggregateId) {
-    await this.request("DELETE", `/multi-suite-runs/${aggregateId}`);
-  }
-  async getRunStatus(runId) {
-    const data = await this.request("GET", `/runs/${runId}`);
-    return { ...data, url: data.run_url ?? `${this.baseUrl}/tests/runs/${runId}` };
-  }
-  /** Request without /ci prefix — for non-CI endpoints like /apps, /tests */
-  async requestRaw(method, path, body) {
-    const url = `${this.baseUrl}/api/v1${path}`;
-    const headers = {
-      Authorization: `Bearer ${this.token}`,
-      "Content-Type": "application/json"
-    };
-    const resp = await fetch(url, {
-      method,
-      headers,
-      body: body ? JSON.stringify(body) : void 0
-    });
-    if (!resp.ok) {
-      const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
-      if (resp.status === 404) throw new Error(`Not found: ${path}`);
-      throw new Error(`API error ${resp.status}: ${text}`);
-    }
-    return resp.json();
-  }
-  /** FormData request without /ci prefix — for file uploads */
-  async requestFormData(method, path, formData) {
-    const url = `${this.baseUrl}/api/v1${path}`;
-    const headers = {
-      Authorization: `Bearer ${this.token}`
-      // Do NOT set Content-Type — let fetch set multipart boundary automatically
-    };
-    const resp = await fetch(url, {
-      method,
-      headers,
-      body: formData
-    });
-    if (!resp.ok) {
-      const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
-      if (resp.status === 404) throw new Error(`Not found: ${path}`);
-      throw new Error(`API error ${resp.status}: ${text}`);
-    }
-    return resp.json();
-  }
-  async listApps() {
-    return this.requestRaw("GET", "/apps/");
-  }
-  async uploadApp(filePath, name) {
-    const fileBuffer = readFileSync2(filePath);
-    const blob = new Blob([fileBuffer]);
-    const formData = new FormData();
-    formData.append("file", blob, basename(filePath));
-    if (name) {
-      formData.append("name", name);
-    }
-    return this.requestFormData("POST", "/apps/upload", formData);
-  }
-  async uploadBuild(appPublicId, filePath, version) {
-    const fileBuffer = readFileSync2(filePath);
-    const blob = new Blob([fileBuffer]);
-    const formData = new FormData();
-    formData.append("file", blob, basename(filePath));
-    if (version) {
-      formData.append("version", version);
-    }
-    return this.requestFormData("POST", `/apps/${appPublicId}/builds`, formData);
-  }
-  async createTest(body) {
-    return this.requestRaw("POST", "/tests/cases/", body);
-  }
-  async runSuites(body) {
-    return this.request("POST", "/run-suites", body);
-  }
-  async getMultiSuiteRun(aggregateId) {
-    return this.request("GET", `/multi-suite-runs/${aggregateId}`);
-  }
-  async listDevices(opts) {
-    const params = new URLSearchParams();
-    if (opts?.type) params.set("device_type", opts.type);
-    if (opts?.category) params.set("category", opts.category);
-    const qs = params.toString();
-    const url = qs ? `/devices?${qs}` : "/devices";
-    const all = await this.requestRaw("GET", url);
-    if (opts?.status) {
-      return all.filter((d) => d.status === opts.status);
-    }
-    return all;
-  }
-  async getDevice(deviceId) {
-    return this.requestRaw("GET", `/devices/${deviceId}`);
-  }
-  async createSession(body) {
-    return this.requestRaw("POST", "/sessions/", body);
-  }
-  async startSession(sessionId, deviceId) {
-    return this.requestRaw("POST", `/sessions/${sessionId}/start`, { device_id: deviceId });
-  }
-  async getSession(sessionId) {
-    return this.requestRaw("GET", `/sessions/${sessionId}`);
-  }
-  async stopSession(sessionId) {
-    await this.requestRaw("DELETE", `/sessions/${sessionId}`);
-  }
-};
-
-// src/lib/spinner.ts
-import ora from "ora";
-function createSpinner(text) {
-  const isCI = process.env.CI === "true" || process.env.CI === "1" || !process.stdout.isTTY;
-  return ora({ text, isEnabled: !isCI, stream: process.stderr });
-}
-
 // src/lib/poll.ts
 import chalk2 from "chalk";
 
@@ -375,11 +177,6 @@ function formatMultiSuiteJunit(result) {
   return lines.join("\n");
 }
 
-// src/lib/types.ts
-var EXIT_PASS = 0;
-var EXIT_TEST_FAIL = 1;
-var EXIT_INFRA_ERROR = 2;
-
 // src/lib/poll.ts
 function printBelowSpinner(spinner, line) {
   const text = spinner.text;
@@ -1071,62 +868,9 @@ async function listApps(options) {
   console.log();
 }
 
-// src/commands/upload-app.ts
-import chalk8 from "chalk";
-import { existsSync } from "fs";
-async function uploadApp(filePath, options) {
-  if (!existsSync(filePath)) {
-    console.error(chalk8.red(`Error: File not found: ${filePath}`));
-    process.exit(EXIT_INFRA_ERROR);
-  }
-  const { token, baseUrl } = resolveAuth(options);
-  const client = new ApiClient(baseUrl, token);
-  const spinner = createSpinner("Uploading app...");
-  spinner.start();
-  try {
-    const result = await client.uploadApp(filePath, options.name);
-    const isNew = result.is_new !== false;
-    spinner.succeed(
-      isNew ? `New app created: ${result.name}` : `Build added to existing app: ${result.name}`
-    );
-    if (options.output === "json") {
-      console.log(
-        JSON.stringify(
-          {
-            app_id: result.public_id,
-            name: result.name,
-            package_name: result.package_name,
-            platform: result.platform,
-            is_new: isNew,
-            url: `${baseUrl}/apps/${result.public_id}`,
-            warnings: result.warnings ?? []
-          },
-          null,
-          2
-        )
-      );
-    } else {
-      console.log(
-        `
-  ${chalk8.cyan(result.public_id)}  ${result.name}  ${chalk8.dim(`[${result.platform}]`)}`
-      );
-      console.log(`  ${chalk8.dim(result.package_name)}`);
-      console.log(chalk8.dim(`  ${baseUrl}/apps/${result.public_id}
-`));
-    }
-    for (const w of result.warnings ?? []) {
-      console.error(chalk8.yellow(`
-\u26A0 ${w}`));
-    }
-  } catch (err) {
-    spinner.fail(err instanceof Error ? err.message : "Upload failed");
-    process.exit(EXIT_INFRA_ERROR);
-  }
-}
-
 // src/commands/create-test.ts
-import chalk9 from "chalk";
-import { existsSync as existsSync2, readFileSync as readFileSync3 } from "fs";
+import chalk8 from "chalk";
+import { existsSync, readFileSync } from "fs";
 async function readStdin() {
   return new Promise((resolve, reject) => {
     let data = "";
@@ -1153,10 +897,10 @@ async function resolveSteps(options) {
     return JSON.parse(options.steps);
   }
   if (options.stepsFile) {
-    if (!existsSync2(options.stepsFile)) {
+    if (!existsSync(options.stepsFile)) {
       throw new Error(`Steps file not found: ${options.stepsFile}`);
     }
-    return JSON.parse(readFileSync3(options.stepsFile, "utf-8"));
+    return JSON.parse(readFileSync(options.stepsFile, "utf-8"));
   }
   if (!process.stdin.isTTY) {
     const input = await readStdin();
@@ -1216,19 +960,19 @@ async function createTest(options) {
       );
     } else {
       console.log(`
-  ${chalk9.cyan(result.public_id)}  ${result.name}`);
+  ${chalk8.cyan(result.public_id)}  ${result.name}`);
       if (result.app_name) {
-        console.log(`  ${chalk9.dim(`App: ${result.app_name}`)}`);
+        console.log(`  ${chalk8.dim(`App: ${result.app_name}`)}`);
       }
       if (result.platform) {
-        console.log(`  ${chalk9.dim(`Platform: ${result.platform}`)}`);
+        console.log(`  ${chalk8.dim(`Platform: ${result.platform}`)}`);
       }
-      console.log(`  ${chalk9.dim(`Steps: ${steps.length}`)}`);
-      console.log(chalk9.dim(`  ${baseUrl}/tests?tab=standalone
+      console.log(`  ${chalk8.dim(`Steps: ${steps.length}`)}`);
+      console.log(chalk8.dim(`  ${baseUrl}/tests?tab=standalone
 `));
     }
   } catch (err) {
-    console.error(chalk9.red(err instanceof Error ? err.message : "Failed to create test"));
+    console.error(chalk8.red(err instanceof Error ? err.message : "Failed to create test"));
     process.exit(EXIT_INFRA_ERROR);
   }
 }
@@ -1278,443 +1022,89 @@ Opening browser to log in...
   process.exit(EXIT_INFRA_ERROR);
 }
 
-// src/commands/dev.ts
-import { select } from "@inquirer/prompts";
-import chalk10 from "chalk";
-import openBrowser from "open";
-
-// src/lib/tunnel-client.ts
-import net from "net";
-import WebSocket from "ws";
-
-// src/lib/mux.ts
-var FRAME_OPEN = 1;
-var FRAME_DATA = 2;
-var FRAME_CLOSE = 3;
-var HEADER_LEN = 5;
-var KNOWN = /* @__PURE__ */ new Set([FRAME_OPEN, FRAME_DATA, FRAME_CLOSE]);
-function encodeFrame(type, streamId, payload = Buffer.alloc(0)) {
-  const header = Buffer.alloc(HEADER_LEN);
-  header.writeUInt8(type, 0);
-  header.writeUInt32BE(streamId, 1);
-  return Buffer.concat([header, payload]);
-}
-function decodeFrame(data) {
-  if (data.length < HEADER_LEN) throw new Error(`tunnel frame too short: ${data.length}`);
-  const type = data.readUInt8(0);
-  if (!KNOWN.has(type)) throw new Error(`unknown tunnel frame type: ${type}`);
-  return { type, streamId: data.readUInt32BE(1), payload: data.subarray(HEADER_LEN) };
-}
-
-// src/lib/tunnel-client.ts
-var FATAL_CLOSE_CODES = /* @__PURE__ */ new Set([4008, 4009]);
-var MAX_BACKOFF_MS = 8e3;
-var STABLE_MS = 2e3;
-var TunnelClient = class {
-  constructor(opts) {
-    this.opts = opts;
-    this.url = opts.url;
-  }
-  ws = null;
-  sockets = /* @__PURE__ */ new Map();
-  stopped = false;
-  backoffMs = 1e3;
-  metroWarned = false;
-  reconnectTimer = null;
-  stableTimer = null;
-  url;
-  connCount = 0;
-  debug(msg) {
-    this.opts.onDebug?.(msg);
-  }
-  start() {
-    this.connect();
-  }
-  stop() {
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer);
-      this.reconnectTimer = null;
-    }
-    if (this.stableTimer) {
-      clearTimeout(this.stableTimer);
-      this.stableTimer = null;
-    }
-    this.stopped = true;
-    this.setState("closed");
-    this.ws?.close();
-    for (const s of this.sockets.values()) s.destroy();
-    this.sockets.clear();
-  }
-  setState(s) {
-    this.opts.onState?.(s);
-  }
-  connect() {
-    if (this.stopped) return;
-    this.setState("connecting");
-    const conn = ++this.connCount;
-    const openedAt = Date.now();
-    this.debug(`ws#${conn} connecting url=${this.url}`);
-    const ws = new WebSocket(this.url);
-    this.ws = ws;
-    ws.on("open", () => {
-      this.backoffMs = 1e3;
-      this.debug(`ws#${conn} open`);
-      this.stableTimer = setTimeout(() => {
-        this.stableTimer = null;
-        if (this.ws === ws && !this.stopped) this.setState("connected");
-      }, STABLE_MS);
-    });
-    ws.on("message", (data) => this.onFrame(data));
-    ws.on("error", (err) => {
-      this.debug(`ws#${conn} error: ${err.message}`);
-    });
-    ws.on("close", (code, reason) => {
-      if (this.ws !== ws) this.debug(`ws#${conn} close code=${code} \u2014 SUPERSEDED socket`);
-      const heldMs = Date.now() - openedAt;
-      const why = reason?.length ? ` reason="${reason.toString()}"` : "";
-      this.debug(`ws#${conn} close code=${code}${why} heldMs=${heldMs}`);
-      if (this.stableTimer) {
-        clearTimeout(this.stableTimer);
-        this.stableTimer = null;
-      }
-      for (const s of this.sockets.values()) s.destroy();
-      this.sockets.clear();
-      if (this.stopped || FATAL_CLOSE_CODES.has(code)) {
-        this.stopped = true;
-        this.setState("closed");
-        return;
-      }
-      this.setState("reconnecting");
-      const delay = this.backoffMs;
-      this.backoffMs = Math.min(this.backoffMs * 2, MAX_BACKOFF_MS);
-      this.debug(`ws#${conn} scheduling reconnect in ${delay}ms`);
-      this.reconnectTimer = setTimeout(() => {
-        this.reconnectTimer = null;
-        void this.reconnect();
-      }, delay);
-    });
-  }
-  async reconnect() {
-    if (this.stopped) return;
-    if (this.opts.refreshUrl) {
-      let fresh;
-      try {
-        fresh = await this.opts.refreshUrl();
-      } catch (err) {
-        this.debug(`refreshUrl threw: ${err.message}`);
-        fresh = null;
-      }
-      if (this.stopped) return;
-      if (!fresh) {
-        this.debug("refreshUrl returned null \u2014 session gone, closing");
-        this.stopped = true;
-        this.setState("closed");
-        return;
-      }
-      this.debug("refreshUrl ok \u2014 reconnecting with fresh url");
-      this.url = fresh;
-    }
-    this.connect();
-  }
-  onFrame(data) {
-    let frame;
-    try {
-      frame = decodeFrame(Buffer.isBuffer(data) ? data : Buffer.from(data));
-    } catch {
-      return;
+// src/commands/dev-status.ts
+import chalk9 from "chalk";
+async function devStatus(opts) {
+  const state = readDevState(process.cwd());
+  if (!state) {
+    if (opts.json) {
+      console.log(JSON.stringify({ running: false }));
+    } else {
+      console.error("No dev session running (or it was not started with --detach).");
     }
-    if (frame.type === FRAME_OPEN) return this.openStream(frame.streamId);
-    const sock = this.sockets.get(frame.streamId);
-    if (!sock) return;
-    if (frame.type === FRAME_DATA) sock.write(frame.payload);
-    else if (frame.type === FRAME_CLOSE) sock.destroy();
-  }
-  openStream(id) {
-    const sock = net.createConnection({ port: this.opts.metroPort, host: "127.0.0.1" });
-    this.sockets.set(id, sock);
-    sock.on("data", (chunk) => this.ws?.send(encodeFrame(FRAME_DATA, id, chunk)));
-    sock.on("error", () => {
-      if (!this.metroWarned) {
-        this.metroWarned = true;
-        this.setState("metro-unreachable");
-      }
-    });
-    sock.on("close", () => {
-      if (this.sockets.delete(id) && this.ws?.readyState === WebSocket.OPEN) {
-        this.ws.send(encodeFrame(FRAME_CLOSE, id));
-      }
-    });
-  }
-};
-
-// src/lib/metro-check.ts
-async function checkMetro(port, timeoutMs = 1500) {
-  try {
-    const res = await fetch(`http://127.0.0.1:${port}/status`, {
-      signal: AbortSignal.timeout(timeoutMs)
-    });
-    const body = await res.text().catch(() => "");
-    return body.includes("packager-status:running") ? "running" : "listening";
-  } catch {
-    return "down";
+    process.exit(1);
+    return;
   }
-}
-
-// src/lib/dev-config.ts
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
-import { join as join2 } from "path";
-var DEV_PLATFORMS = ["ios", "android", "tvos", "androidtv"];
-var FILE = "vibeview.json";
-function isDevPlatform(p) {
-  return typeof p === "string" && DEV_PLATFORMS.includes(p);
-}
-function loadDevConfig(cwd) {
-  let raw;
+  const { token, baseUrl } = resolveAuth(opts);
+  const api = new ApiClient(baseUrl, token);
+  let sessionStatus;
   try {
-    raw = readFileSync4(join2(cwd, FILE), "utf-8");
+    const info = await api.getSession(state.session_id);
+    sessionStatus = info.status;
   } catch {
-    return null;
-  }
-  const parsed = JSON.parse(raw);
-  if (!("platforms" in parsed) && typeof parsed.platform === "string") {
-    const legacy = parsed;
-    if (!isDevPlatform(legacy.platform)) {
-      throw new Error(
-        `vibeview.json: "platform" must be one of ${DEV_PLATFORMS.join(", ")}, got "${legacy.platform}"`
-      );
-    }
-    if (!legacy.appId || typeof legacy.appId !== "string") {
-      throw new Error('vibeview.json: "appId" is required \u2014 run `vibeview dev` to set it up');
-    }
-    return {
-      defaultPlatform: legacy.platform,
-      metroPort: legacy.metroPort,
-      platforms: {
-        [legacy.platform]: { appId: legacy.appId, deviceCategory: legacy.deviceCategory }
-      }
-    };
-  }
-  const cfg = parsed;
-  if (!isDevPlatform(cfg.defaultPlatform)) {
-    throw new Error(
-      `vibeview.json: "defaultPlatform" must be one of ${DEV_PLATFORMS.join(", ")}, got "${String(cfg.defaultPlatform)}"`
+    sessionStatus = void 0;
+  }
+  const metro = readMetroState(process.cwd());
+  if (opts.json) {
+    console.log(
+      JSON.stringify({
+        running: true,
+        pid: state.pid,
+        session_id: state.session_id,
+        page_url: state.page_url,
+        platform: state.platform,
+        app_id: state.app_id,
+        metro_port: state.metro_port,
+        started_at: state.started_at,
+        session_status: sessionStatus ?? null,
+        ...metro ? { owned_metro_pid: metro.pid, owned_metro_port: metro.port } : {}
+      })
     );
-  }
-  if (!cfg.platforms || typeof cfg.platforms !== "object") {
-    throw new Error(
-      'vibeview.json: "platforms" object is required \u2014 run `vibeview dev` to set it up'
-    );
-  }
-  for (const [key, entry] of Object.entries(cfg.platforms)) {
-    if (!isDevPlatform(key)) {
-      throw new Error(
-        `vibeview.json: unknown platform "${key}" (expected one of ${DEV_PLATFORMS.join(", ")})`
-      );
-    }
-    if (!entry || typeof entry.appId !== "string" || !entry.appId) {
-      throw new Error(`vibeview.json: platforms.${key}.appId is required`);
-    }
-  }
-  return cfg;
-}
-function saveDevConfig(cwd, cfg) {
-  writeFileSync2(join2(cwd, FILE), JSON.stringify(cfg, null, 2) + "\n");
+  } else {
+    console.error(`dev session running (pid ${state.pid})`);
+    console.error(`  session:  ${state.session_id}${sessionStatus ? ` (${sessionStatus})` : ""}`);
+    console.error(`  platform: ${state.platform}`);
+    console.error(`  app:      ${state.app_id}`);
+    console.error(`  url:      ${state.page_url}`);
+    console.error(`  started:  ${state.started_at}`);
+  }
+  if (metro) console.error(chalk9.dim(`Metro: pid ${metro.pid} on :${metro.port} (CLI-owned)`));
+  process.exit(0);
 }
 
-// src/commands/dev.ts
-function findBlockingWarning(info) {
-  return (info.warnings ?? []).find((w) => w.includes("No debug build"));
-}
-async function pollUntilTunnelReady(api, sessionId, timeoutMs, intervalMs = 2e3) {
-  const deadline = Date.now() + timeoutMs;
-  for (; ; ) {
-    const info = await api.getSession(sessionId);
-    const blocking = findBlockingWarning(info);
-    if (blocking) throw new Error(blocking);
-    if (info.tunnel_url) return info;
-    if (info.status === "stopped" || info.status === "failed") {
-      throw new Error(`session ${info.status} before the tunnel came up`);
-    }
-    if (Date.now() > deadline) throw new Error("timed out waiting for the device to start");
-    await new Promise((r) => setTimeout(r, intervalMs));
-  }
-}
-var PLATFORM_DEVICE = {
-  ios: { deviceType: "ios", tv: false },
-  android: { deviceType: "android", tv: false },
-  tvos: { deviceType: "ios", tv: true },
-  androidtv: { deviceType: "android", tv: true }
-};
-function appsForPlatform(apps, platform) {
-  return apps.filter((a) => a.platform === platform);
-}
-async function ensureConfig(api, opts) {
-  const existing = loadDevConfig(process.cwd());
-  if (opts.platform && !isDevPlatform(opts.platform)) {
-    console.error(chalk10.red(`error: --platform must be one of ios, android, tvos, androidtv`));
-    process.exit(2);
-  }
-  const platform = opts.platform || existing?.defaultPlatform || await select({
-    message: "Platform to run on",
-    choices: [
-      { value: "ios", name: "iOS simulator" },
-      { value: "android", name: "Android emulator" },
-      { value: "tvos", name: "Apple TV simulator" },
-      { value: "androidtv", name: "Android TV emulator" }
-    ]
-  });
-  const isTv = PLATFORM_DEVICE[platform].tv;
-  if (isTv && opts.deviceCategory) {
-    console.error(
-      chalk10.red(`error: --device-category does not apply to ${platform} (always a tv device)`)
-    );
-    process.exit(2);
-  }
-  if (!isTv && opts.deviceCategory === "tv") {
-    console.error(chalk10.red(`error: use --platform tvos or --platform androidtv for TV devices`));
-    process.exit(2);
-  }
-  const entry = existing?.platforms?.[platform];
-  let appId = opts.app || entry?.appId;
-  if (!appId) {
-    const apps = appsForPlatform(await api.listApps(), platform);
-    if (apps.length === 0) {
-      console.error(
-        chalk10.red(`No ${platform} apps found \u2014 upload a debug build with \`vibeview upload-app\``)
-      );
-      process.exit(1);
+// src/commands/dev-stop.ts
+async function devStop(opts) {
+  const state = readDevState(process.cwd());
+  if (!state) {
+    if (opts.json) {
+      console.log(JSON.stringify({ stopped: false, reason: "no_dev_session" }));
+    } else {
+      console.error("No dev session running (or it was not started with --detach).");
     }
-    appId = await select({
-      message: "Which uploaded app is your debug build? (upload one with `vibeview upload-app`)",
-      // Platform suffix dropped: the picker is already filtered to one platform
-      // (appsForPlatform), so `(ios)` on every row is redundant noise.
-      choices: apps.map((a) => ({ value: a.public_id, name: a.name }))
-    });
+    process.exit(1);
+    return;
   }
-  const deviceCategory = isTv ? "tv" : opts.deviceCategory || entry?.deviceCategory || "phone";
-  const metroPort = opts.metroPort ? parseInt(opts.metroPort, 10) : existing?.metroPort ?? 8081;
-  const cfg = {
-    defaultPlatform: platform,
-    metroPort,
-    platforms: {
-      ...existing?.platforms,
-      [platform]: { appId, deviceCategory: isTv ? void 0 : deviceCategory }
-    }
-  };
-  saveDevConfig(process.cwd(), cfg);
-  return { platform, appId, deviceCategory, metroPort };
-}
-async function dev(opts) {
   const { token, baseUrl } = resolveAuth(opts);
-  console.error(chalk10.dim(`Using ${baseUrl}`));
   const api = new ApiClient(baseUrl, token);
-  const cfg = await ensureConfig(api, opts);
-  const metroPort = cfg.metroPort ?? 8081;
-  const metro = await checkMetro(metroPort);
-  if (metro === "down") {
-    console.error(
-      chalk10.red(`error: Metro isn't running on localhost:${metroPort}.`) + `
-Start it in your project first (yarn start), then re-run vibeview dev.
-If Metro uses another port, pass --metro-port <port>.`
-    );
-    process.exit(1);
-  }
-  if (metro === "listening") {
-    console.error(
-      chalk10.yellow(
-        `\u26A0 something is listening on localhost:${metroPort} but it doesn't look like Metro \u2014 continuing anyway`
-      )
-    );
-  }
-  console.error(chalk10.dim(`Starting a ${cfg.platform} dev session for ${cfg.appId}...`));
-  const created = await api.createSession({
-    device_type: PLATFORM_DEVICE[cfg.platform].deviceType,
-    device_category: cfg.deviceCategory,
-    app_id: cfg.appId,
-    tunnel: true
+  await api.stopSession(state.session_id).catch(() => {
   });
-  const sessionId = created.session_id;
-  let stopping = false;
-  const stopSession = async (code) => {
-    if (stopping) return;
-    stopping = true;
-    tunnel?.stop();
-    console.error(chalk10.dim("\nStopping session..."));
-    await api.stopSession(sessionId).catch(() => {
-    });
-    process.exit(code);
-  };
-  process.on("SIGINT", () => void stopSession(0));
-  process.on("SIGTERM", () => void stopSession(0));
-  let tunnel = null;
   try {
-    await api.startSession(sessionId);
-    const ready = await pollUntilTunnelReady(api, sessionId, 18e4);
-    for (const w of ready.warnings ?? []) {
-      console.error(chalk10.yellow(`\u26A0 ${w}`));
-    }
-    let everConnected = false;
-    let waitingPrinted = false;
-    tunnel = new TunnelClient({
-      url: ready.tunnel_url,
-      metroPort: cfg.metroPort ?? 8081,
-      // Re-mint the URL on each reconnect: the tunnel token has a ~1h TTL and
-      // a worker restart drops the proxy registration, so the original URL
-      // eventually goes stale. Every authorized GET /sessions/{id} re-signs a
-      // fresh tunnel token. Null (session stopped/failed) ends the tunnel.
-      refreshUrl: async () => {
-        const info = await api.getSession(sessionId);
-        if (info.status === "stopped" || info.status === "failed") return null;
-        return info.tunnel_url ?? null;
-      },
-      // --debug: dump raw tunnel lifecycle (close codes/reasons, reconnect
-      // scheduling, url refresh) to diagnose flapping. Timestamped so the
-      // drop→reconnect cadence is visible.
-      onDebug: opts.debug ? (msg) => console.error(chalk10.dim(`[tunnel ${(/* @__PURE__ */ new Date()).toISOString()}] ${msg}`)) : void 0,
-      onState: (s) => {
-        if (s === "connected") {
-          everConnected = true;
-          console.error(chalk10.green("\u2713 tunnel connected \u2014 edit away, Fast Refresh is live"));
-        } else if (s === "reconnecting") {
-          if (!everConnected) {
-            if (!waitingPrinted) {
-              waitingPrinted = true;
-              console.error(
-                chalk10.dim("\u2026 waiting for the device to come up (tunnel not ready yet)")
-              );
-            }
-            return;
-          }
-          console.error(chalk10.yellow("\u2026 tunnel dropped, reconnecting"));
-        } else if (s === "metro-unreachable")
-          console.error(
-            chalk10.red(
-              `\u2717 can't reach Metro on localhost:${cfg.metroPort ?? 8081} \u2014 is it running? (yarn start)`
-            )
-          );
-        else if (s === "closed" && !stopping) {
-          console.error(chalk10.red("tunnel closed by server \u2014 session ended"));
-          void stopSession(1);
-        }
-      }
-    });
-    tunnel.start();
-    const webBase = opts.webUrl || process.env.VIBEVIEW_WEB_URL || baseUrl;
-    const pageUrl = `${webBase}/sandbox/${sessionId}`;
-    console.error(`
-  Watch and interact: ${chalk10.cyan(pageUrl)}
-  Ctrl-C to end the session.
-`);
-    if (opts.open !== false) await openBrowser(pageUrl).catch(() => {
-    });
+    process.kill(state.pid, "SIGTERM");
   } catch (err) {
-    console.error(chalk10.red(`error: ${err.message}`));
-    await stopSession(1);
+    if (err.code !== "ESRCH") throw err;
+  }
+  clearDevState(process.cwd());
+  killOwnedMetro(process.cwd());
+  if (opts.json) {
+    console.log(JSON.stringify({ stopped: true, session_id: state.session_id, pid: state.pid }));
+  } else {
+    console.error(`Stopped dev session ${state.session_id} (pid ${state.pid}).`);
   }
+  process.exit(0);
 }
 
 // src/lib/formatters/devices.ts
-import chalk11 from "chalk";
+import chalk10 from "chalk";
 var HEADERS = ["DEVICE_ID", "NAME", "TYPE", "CATEGORY", "OS", "STATUS"];
 function formatDevicesHuman(devices) {
   if (devices.length === 0) {
@@ -1730,9 +1120,9 @@ function formatDevicesHuman(devices) {
   ]);
   const widths = HEADERS.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
-  const lines = [chalk11.bold(fmt(HEADERS))];
+  const lines = [chalk10.bold(fmt(HEADERS))];
   for (const row of rows.sort(rowSort)) {
-    const statusColored = row[5] === "available" ? chalk11.green(row[5]) : row[5] === "busy" ? chalk11.yellow(row[5]) : chalk11.dim(row[5]);
+    const statusColored = row[5] === "available" ? chalk10.green(row[5]) : row[5] === "busy" ? chalk10.yellow(row[5]) : chalk10.dim(row[5]);
     lines.push(fmt([row[0], row[1], row[2], row[3], row[4], statusColored]));
   }
   return lines.join("\n") + "\n";
@@ -1765,7 +1155,7 @@ async function listDevicesCommand(options) {
 }
 
 // src/lib/metadata.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 var MAX_METADATA_BYTES = 16384;
 var MAX_METADATA_DEPTH = 4;
 function measureDepth(value, current = 1) {
@@ -1804,7 +1194,7 @@ function parseMetadata(raw) {
 function readMetadataFile(path) {
   let raw;
   try {
-    raw = readFileSync5(path, "utf8");
+    raw = readFileSync2(path, "utf8");
   } catch (e) {
     throw new Error(`failed to read --metadata-file ${path}: ${e.message}`);
   }
@@ -1856,7 +1246,7 @@ function resolveMetadata(opts) {
 }
 var program = new Command();
 program.name("vibeview").description("VibeView CLI -- run mobile tests from CI/CD pipelines").version(pkg.version);
-program.command("run-suite <suite-id>").description("Run all test cases in a suite").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--base-url <url>", "VibeView server URL (or set VIBEVIEW_BASE_URL)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-case breakdown", false).option("--timeout <seconds>", "Max wait time in seconds", "300").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+program.command("run-suite <suite-id>").description("Run all test cases in a suite").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-case breakdown", false).option("--timeout <seconds>", "Max wait time in seconds", "300").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: phone when --device is not set)",
   parseDeviceCategory
@@ -1884,7 +1274,7 @@ program.command("run-suites").description("Run all suites matching a tag filter"
 ).option("--match <mode>", "any (default) or all", "any").option(
   "--platform <platform>",
   "Filter matched suites to one platform: ios, android, tvos, androidtv (default: no filter)"
-).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--base-url <url>", "VibeView server URL (or set VIBEVIEW_BASE_URL)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-suite progress", false).option("--timeout <seconds>", "Per-suite timeout, capped at 2 hours total", "300").option("--commit-sha <sha>", "Git commit SHA propagated to every SuiteRun").option("--model <model>", "AI model").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-suite progress", false).option("--timeout <seconds>", "Per-suite timeout, capped at 2 hours total", "300").option("--commit-sha <sha>", "Git commit SHA propagated to every SuiteRun").option("--model <model>", "AI model").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: phone when --device is not set)",
   parseDeviceCategory
@@ -1904,7 +1294,7 @@ program.command("run-suites").description("Run all suites matching a tag filter"
     build: opts.build ? parseInt(opts.build, 10) : void 0
   });
 });
-program.command("run-test <test-id>").description("Run a single test case").option("--token <token>", "API token").option("--base-url <url>", "VibeView server URL").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show step details", false).option("--timeout <seconds>", "Max wait time in seconds", "300").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+program.command("run-test <test-id>").description("Run a single test case").option("--token <token>", "API token").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show step details", false).option("--timeout <seconds>", "Max wait time in seconds", "300").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: phone when --device is not set)",
   parseDeviceCategory
@@ -1924,24 +1314,59 @@ program.command("run-test <test-id>").description("Run a single test case").opti
     build: opts.build ? parseInt(opts.build, 10) : void 0
   });
 });
-program.command("list-suites").description("List available test suites").option("--token <token>", "API token").option("--base-url <url>", "VibeView server URL").option("--output <format>", "Output format: human, json", "human").option(
+program.command("list-suites").description("List available test suites").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option(
   "--tag <tag>",
   "Filter suites by tag (repeatable)",
   (val, prev = []) => [...prev, val],
   []
 ).option("--match <mode>", "When multiple --tag flags: any (default) or all", "any").action((opts) => listSuites(opts));
-program.command("list-apps").description("List apps in your organization").option("--token <token>", "API token").option("--base-url <url>", "VibeView server URL").option("--output <format>", "Output format: human, json", "human").action((opts) => listApps(opts));
-program.command("list-devices").description("List devices registered with the platform (filterable by type and category)").option("--token <token>", "API token").option("--base-url <url>", "VibeView server URL").option("--output <format>", "Output format: human, json", "human").option("--type <type>", "Filter by device type: ios, android").option("--category <category>", "Filter by category: phone, tablet, tv").option("--status <status>", "Filter by status: available, busy, offline").action((opts) => listDevicesCommand(opts));
-program.command("upload-app <file>").description("Upload an app build (zipped simulator .app for iOS, .apk for Android)").option("--token <token>", "API token").option("--base-url <url>", "VibeView server URL").option("--output <format>", "Output format: human, json", "human").option("--name <name>", "App name (auto-detected if not provided)").action((file, opts) => uploadApp(file, opts));
-program.command("create-test [name]").description("Create a standalone AI test case").option("--token <token>", "API token").option("--base-url <url>", "VibeView server URL").option("--output <format>", "Output format: human, json", "human").option("--app <app>", "App ID (public_id) or package name (requires --platform)").option("--platform <platform>", "Platform (ios, android) when using package name for --app").option("--steps <json>", "Test steps as inline JSON array").option("--steps-file <path>", "Path to JSON file containing test steps").option("--context <text>", "Additional context for AI test execution").option("--test-name <name>", "Test case name (alternative to positional arg)").action((name, opts) => createTest({ ...opts, testName: name || opts.testName || "CLI Test" }));
-program.command("login").description("Log in to VibeView (interactive)").option("--base-url <url>", "VibeView server URL").action((opts) => login(opts));
-program.command("dev").description("Stream your app from the fleet with live Metro hot-reload (RN debug builds)").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--base-url <url>", "VibeView server URL (or set VIBEVIEW_BASE_URL)").option("--web-url <url>", "Dashboard URL if different from --base-url (local dev)").option(
+program.command("list-apps").description("List apps in your organization").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").action((opts) => listApps(opts));
+program.command("list-devices").description("List devices registered with the platform (filterable by type and category)").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--type <type>", "Filter by device type: ios, android").option("--category <category>", "Filter by category: phone, tablet, tv").option("--status <status>", "Filter by status: available, busy, offline").action((opts) => listDevicesCommand(opts));
+program.command("upload-app <file>").description("Upload an app build (zipped simulator .app for iOS, .apk for Android)").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--name <name>", "App name (auto-detected if not provided)").action((file, opts) => uploadApp(file, opts));
+program.command("create-test [name]").description("Create a standalone AI test case").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--app <app>", "App ID (public_id) or package name (requires --platform)").option("--platform <platform>", "Platform (ios, android) when using package name for --app").option("--steps <json>", "Test steps as inline JSON array").option("--steps-file <path>", "Path to JSON file containing test steps").option("--context <text>", "Additional context for AI test execution").option("--test-name <name>", "Test case name (alternative to positional arg)").action((name, opts) => createTest({ ...opts, testName: name || opts.testName || "CLI Test" }));
+program.command("login").description("Log in to VibeView (interactive)").option("--base-url <url>", "VibeView server URL (defaults to https://vibeview.io)").action((opts) => login(opts));
+program.command("dev").description("Stream your app from the fleet with live Metro hot-reload (RN debug builds)").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--web-url <url>", "Dashboard URL if different from the API URL (local dev)").option(
   "--platform <platform>",
   "ios, android, tvos, or androidtv (first run is interactive otherwise)"
 ).option("--app <app_id>", "Uploaded debug build to run (see `vibeview list-apps`)").option("--metro-port <port>", "Local Metro port (default: 8081, remembered in vibeview.json)").option(
   "--device-category <category>",
   "phone or tablet (default: phone; TV platforms always use tv)",
   parseDeviceCategory
-).option("--no-open", "Do not open the browser automatically").option("--debug", "Log raw tunnel lifecycle events (close codes, reconnects) for diagnostics").action((opts) => dev(opts));
+).option("--no-open", "Do not open the browser automatically").option("--debug", "Log raw tunnel lifecycle events (close codes, reconnects) for diagnostics").option("--json", "Emit line-delimited JSON events on stdout instead of human output", false).option(
+  "--detach",
+  "Run the dev session in the background; prints session info and exits (see `dev-status`, `dev-stop`)",
+  false
+).option(
+  "--build",
+  "Build and upload first (uses platforms.<platform>.build from vibeview.json)",
+  false
+).action((opts) => dev(opts));
+program.command("build").description("Run your configured build command and upload the result (see vibeview.json)").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option(
+  "--platform <platform>",
+  "ios, android, tvos, or androidtv (default: vibeview.json defaultPlatform)"
+).option("--json", "Print the result as one JSON line", false).action((opts) => buildCommand(opts));
+program.command("dev-status").description("Show the status of a `vibeview dev --detach` session in this project").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--json", "Print as one JSON line", false).action((opts) => devStatus(opts));
+program.command("dev-stop").description("Stop a `vibeview dev --detach` session in this project").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--json", "Print as one JSON line", false).action((opts) => devStop(opts));
+program.command("mcp").description(
+  "Run an MCP stdio server exposing the agent verbs (tap, swipe, type, ...) plus dev_start/dev_stop as tools"
+).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").action(async (opts) => {
+  const { runMcpServer } = await import("./server-JZAEEHZT.js");
+  await runMcpServer(opts);
+});
+for (const cmd of AGENT_COMMANDS) {
+  const positionalParams = cmd.params.filter((p) => p.cli === "positional");
+  const flagParams = cmd.params.filter((p) => p.cli !== "positional");
+  const argSignature = positionalParams.map((p) => p.required ? `<${p.name}>` : `[${p.name}]`).join(" ");
+  let command = program.command(argSignature ? `${cmd.verb} ${argSignature}` : cmd.verb).description(cmd.summary);
+  for (const param of flagParams) {
+    const flagArg = param.type === "number" ? `${param.cli} <n>` : `${param.cli} <value>`;
+    command = command.option(flagArg, param.description);
+  }
+  command = command.option("--session <id>", "Session ID to target (or use dev-loop session state)").option("--json", "Print the raw response envelope as one JSON line", false).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)");
+  command.action((...args) => {
+    const opts = args[args.length - 2];
+    const positionals = args.slice(0, positionalParams.length);
+    return runAgentVerb(cmd, positionals, opts);
+  });
+}
 program.parse();
-//# sourceMappingURL=cli.js.map