@yoqa/cli 0.3.8 → 0.3.10

package/dist/main.js

@@ -6184,6 +6184,75 @@ var ensureRuntimeResponseSchema = exports_external.object({
   installed: exports_external.array(setupPlatformResponseSchema),
   message: exports_external.string().min(1)
 });
+var serverKindSchema = exports_external.union([
+  exports_external.literal("appium"),
+  exports_external.literal("runner"),
+  exports_external.literal("device-session")
+]);
+var serverOwnershipSchema = exports_external.union([
+  exports_external.literal("managed"),
+  exports_external.literal("foreign"),
+  exports_external.literal("self")
+]);
+var serverActionSchema = exports_external.union([exports_external.literal("stop"), exports_external.literal("restart")]);
+var serverEntrySchema = exports_external.object({
+  id: exports_external.string().min(1),
+  kind: serverKindSchema,
+  ownership: serverOwnershipSchema,
+  label: exports_external.string().min(1),
+  status: exports_external.string().min(1),
+  pid: exports_external.number().int().positive().optional(),
+  port: exports_external.number().int().positive().optional(),
+  deviceId: exports_external.string().min(1).optional(),
+  platform: devicePlatformSchema.optional(),
+  startedAt: exports_external.number().nonnegative().optional(),
+  actions: exports_external.array(serverActionSchema)
+});
+var listServersResponseSchema = exports_external.object({
+  servers: exports_external.array(serverEntrySchema)
+});
+var serverMutationResponseSchema = exports_external.object({
+  ok: exports_external.literal(true),
+  message: exports_external.string().min(1),
+  servers: exports_external.array(serverEntrySchema)
+});
+var doctorCheckStatusSchema = exports_external.union([
+  exports_external.literal("pass"),
+  exports_external.literal("fail"),
+  exports_external.literal("warn")
+]);
+var doctorRepairIdSchema = exports_external.union([
+  exports_external.literal("ensure-runtime"),
+  exports_external.literal("stop-foreign-appium"),
+  exports_external.literal("disconnect-session")
+]);
+var doctorCheckSchema = exports_external.object({
+  id: exports_external.string().min(1),
+  label: exports_external.string().min(1),
+  status: doctorCheckStatusSchema,
+  detail: exports_external.string().optional(),
+  fixHint: exports_external.string().optional()
+});
+var doctorStepSchema = exports_external.object({
+  severity: exports_external.union([exports_external.literal("error"), exports_external.literal("warn"), exports_external.literal("info")]),
+  title: exports_external.string().min(1),
+  detail: exports_external.string().min(1),
+  repair: doctorRepairIdSchema.optional()
+});
+var doctorReportSchema = exports_external.object({
+  ok: exports_external.boolean(),
+  checks: exports_external.array(doctorCheckSchema),
+  servers: exports_external.array(serverEntrySchema),
+  steps: exports_external.array(doctorStepSchema)
+});
+var doctorRepairRequestSchema = exports_external.object({
+  repairs: exports_external.array(doctorRepairIdSchema).min(1)
+});
+var doctorRepairResponseSchema = exports_external.object({
+  ok: exports_external.literal(true),
+  message: exports_external.string().min(1),
+  report: doctorReportSchema
+});
 var capabilitySchema = exports_external.object({
   id: exports_external.string().min(1),
   key: exports_external.string(),
@@ -6384,6 +6453,22 @@ var aiProviderSchema = exports_external.object({
 var listProvidersResponseSchema = exports_external.object({
   providers: exports_external.array(aiProviderSchema)
 });
+var providerDriverCapabilitiesSchema = exports_external.object({
+  vision: exports_external.boolean()
+});
+var providerDriverCatalogEntrySchema = exports_external.object({
+  kind: providerKindSchema,
+  label: exports_external.string().min(1),
+  description: exports_external.string().nullable(),
+  authModes: exports_external.array(providerAuthModeSchema).min(1),
+  defaultBinary: exports_external.string().nullable(),
+  envHints: exports_external.array(exports_external.string()),
+  loginInstructions: exports_external.string().nullable(),
+  capabilities: providerDriverCapabilitiesSchema
+});
+var listProviderCatalogResponseSchema = exports_external.object({
+  drivers: exports_external.array(providerDriverCatalogEntrySchema)
+});
 var createProviderRequestSchema = exports_external.object({
   kind: providerKindSchema,
   authMode: providerAuthModeSchema.optional(),
@@ -7396,6 +7481,73 @@ class RunnerClient {
     }
     return ensureRuntimeResponseSchema.parse(json);
   }
+  async listServers(options = {}) {
+    const response = await this.fetchImpl(`${this.baseUrl}/servers`, {
+      signal: options.signal
+    });
+    const json = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(errorMessageFromBody(json, `List servers failed: HTTP ${response.status}`));
+    }
+    return listServersResponseSchema.parse(json);
+  }
+  async stopAllServers(options = {}) {
+    const response = await this.fetchImpl(`${this.baseUrl}/servers/stop-all`, {
+      method: "POST",
+      signal: options.signal
+    });
+    const json = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(errorMessageFromBody(json, `Stop all servers failed: HTTP ${response.status}`));
+    }
+    return serverMutationResponseSchema.parse(json);
+  }
+  async stopServer(id, options = {}) {
+    const response = await this.fetchImpl(`${this.baseUrl}/servers/${encodeURIComponent(id)}/stop`, {
+      method: "POST",
+      signal: options.signal
+    });
+    const json = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(errorMessageFromBody(json, `Stop server failed: HTTP ${response.status}`));
+    }
+    return serverMutationResponseSchema.parse(json);
+  }
+  async restartServer(id, options = {}) {
+    const response = await this.fetchImpl(`${this.baseUrl}/servers/${encodeURIComponent(id)}/restart`, {
+      method: "POST",
+      signal: options.signal
+    });
+    const json = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(errorMessageFromBody(json, `Restart server failed: HTTP ${response.status}`));
+    }
+    return serverMutationResponseSchema.parse(json);
+  }
+  async getDoctorReport(options = {}) {
+    const response = await this.fetchImpl(`${this.baseUrl}/doctor`, {
+      signal: options.signal
+    });
+    const json = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(errorMessageFromBody(json, `Doctor failed: HTTP ${response.status}`));
+    }
+    return doctorReportSchema.parse(json);
+  }
+  async repairDoctor(request, options = {}) {
+    const body = doctorRepairRequestSchema.parse(request);
+    const response = await this.fetchImpl(`${this.baseUrl}/doctor/repair`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal: options.signal
+    });
+    const json = await response.json().catch(() => null);
+    if (!response.ok) {
+      throw new Error(errorMessageFromBody(json, `Doctor repair failed: HTTP ${response.status}`));
+    }
+    return doctorRepairResponseSchema.parse(json);
+  }
   async listApps() {
     const json = await this.requestJson("/apps", undefined, "List apps failed");
     return listAppsResponseSchema.parse(json).apps;
@@ -7499,6 +7651,10 @@ class RunnerClient {
     const json = await this.requestJson("/providers", undefined, "List providers failed");
     return listProvidersResponseSchema.parse(json).providers;
   }
+  async listProviderCatalog() {
+    const json = await this.requestJson("/providers/catalog", undefined, "List provider catalog failed");
+    return listProviderCatalogResponseSchema.parse(json).drivers;
+  }
   async getProvider(providerId) {
     const json = await this.requestJson(`/providers/${encodeURIComponent(providerId)}`, undefined, "Get provider failed");
     return aiProviderSchema.parse(json);
@@ -7694,7 +7850,7 @@ var {
 // package.json
 var package_default = {
   name: "@yoqa/cli",
-  version: "0.3.8",
+  version: "0.3.10",
   description: "Yoqa CLI — drive local mobile QA from the terminal or CI (talks to the Yoqa runner over HTTP)",
   license: "UNLICENSED",
   type: "module",
@@ -8036,6 +8192,156 @@ runtime.command("ensure").description("Install Appium + both platform drivers if
     fail("runtime ensure", error);
   }
 });
+var servers = program2.command("servers").description("List or control local Appium, runner, and device sessions").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").action(async (options) => {
+  try {
+    const body = await client(options.baseUrl).listServers();
+    if (options.json) {
+      console.log(JSON.stringify(body, null, 2));
+      return;
+    }
+    if (body.servers.length === 0) {
+      console.log("No servers running");
+      return;
+    }
+    for (const entry of body.servers) {
+      const meta = [
+        entry.kind,
+        entry.ownership,
+        entry.status,
+        entry.port ? `:${entry.port}` : null,
+        entry.pid ? `pid ${entry.pid}` : null,
+        entry.actions.length > 0 ? `actions=${entry.actions.join(",")}` : "actions=none"
+      ].filter(Boolean).join(" · ");
+      console.log(`${entry.id}	${entry.label}	${meta}`);
+    }
+  } catch (error) {
+    fail("servers", error);
+  }
+});
+servers.command("list").description("List running servers").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").action(async (options) => {
+  try {
+    const body = await client(options.baseUrl).listServers();
+    if (options.json) {
+      console.log(JSON.stringify(body, null, 2));
+      return;
+    }
+    if (body.servers.length === 0) {
+      console.log("No servers running");
+      return;
+    }
+    for (const entry of body.servers) {
+      const meta = [
+        entry.kind,
+        entry.ownership,
+        entry.status,
+        entry.port ? `:${entry.port}` : null,
+        entry.pid ? `pid ${entry.pid}` : null,
+        entry.actions.length > 0 ? `actions=${entry.actions.join(",")}` : "actions=none"
+      ].filter(Boolean).join(" · ");
+      console.log(`${entry.id}	${entry.label}	${meta}`);
+    }
+  } catch (error) {
+    fail("servers list", error);
+  }
+});
+servers.command("stop-all").description("Stop Appium processes and disconnect the device session (does not stop the runner)").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").action(async (options) => {
+  try {
+    const body = await client(options.baseUrl).stopAllServers();
+    if (options.json) {
+      console.log(JSON.stringify(body, null, 2));
+      return;
+    }
+    console.log(body.message);
+  } catch (error) {
+    fail("servers stop-all", error);
+  }
+});
+servers.command("stop").description("Stop one server by id").argument("<id>", "Server id from yoqa servers list").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").action(async (id, options) => {
+  try {
+    if (id === "runner-self") {
+      throw new Error("Stopping the runner over HTTP is not supported. Quit the desktop app or kill the process on the runner port.");
+    }
+    const body = await client(options.baseUrl).stopServer(id);
+    if (options.json) {
+      console.log(JSON.stringify(body, null, 2));
+      return;
+    }
+    console.log(body.message);
+  } catch (error) {
+    fail("servers stop", error);
+  }
+});
+servers.command("restart").description("Restart one server by id").argument("<id>", "Server id from yoqa servers list").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").action(async (id, options) => {
+  try {
+    if (id === "runner-self") {
+      throw new Error("Restarting the runner over HTTP is not supported while it is serving requests. Prefer the desktop Servers panel.");
+    }
+    const body = await client(options.baseUrl).restartServer(id);
+    if (options.json) {
+      console.log(JSON.stringify(body, null, 2));
+      return;
+    }
+    console.log(body.message);
+  } catch (error) {
+    fail("servers restart", error);
+  }
+});
+program2.command("doctor").description("Diagnose local tooling, drivers, and leftover Appium processes").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").option("--fix", "Apply safe repairs (ensure runtime, stop foreign Appium, disconnect session)").action(async (options) => {
+  try {
+    const c = client(options.baseUrl);
+    if (options.fix) {
+      const report2 = await c.getDoctorReport();
+      const repairs = [
+        ...new Set(report2.steps.map((step) => step.repair).filter((id) => Boolean(id)))
+      ];
+      if (repairs.length === 0) {
+        if (options.json) {
+          console.log(JSON.stringify({ ok: true, message: "No safe repairs", report: report2 }, null, 2));
+        } else {
+          console.log("No safe repairs to apply");
+        }
+        if (!report2.ok)
+          process.exitCode = 1;
+        return;
+      }
+      const result = await c.repairDoctor({ repairs });
+      if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+      } else {
+        console.log(result.message);
+        console.log(result.report.ok ? "doctor: ok" : "doctor: issues remain");
+        for (const check of result.report.checks) {
+          console.log(`  [${check.status}] ${check.label}${check.detail ? ` — ${check.detail}` : ""}`);
+        }
+        for (const step of result.report.steps) {
+          console.log(`  → [${step.severity}] ${step.title}: ${step.detail}`);
+        }
+      }
+      if (!result.report.ok)
+        process.exitCode = 1;
+      return;
+    }
+    const report = await c.getDoctorReport();
+    if (options.json) {
+      console.log(JSON.stringify(report, null, 2));
+    } else {
+      console.log(report.ok ? "doctor: ok" : "doctor: issues found");
+      for (const check of report.checks) {
+        console.log(`  [${check.status}] ${check.label}${check.detail ? ` — ${check.detail}` : ""}`);
+      }
+      if (report.steps.length > 0) {
+        console.log("steps:");
+        for (const step of report.steps) {
+          console.log(`  → [${step.severity}] ${step.title}: ${step.detail}`);
+        }
+      }
+    }
+    if (!report.ok)
+      process.exitCode = 1;
+  } catch (error) {
+    fail("doctor", error);
+  }
+});
 var assertCmd = program2.command("assert").description("Assert text visibility on the active device");
 for (const kind of ["visible", "not-visible"]) {
   assertCmd.command(kind).description(kind === "visible" ? "Fail unless matching text appears in the cleaned screen tree" : "Fail if matching text is still present in the cleaned screen tree").option("--base-url <url>", "Runner base URL", runnerBaseUrl()).option("--json", "Print raw JSON").requiredOption("-t, --text <text>", "Text / label substring to match").option("--timeout <seconds>", "Seconds to wait before failing", (v) => Number(v), 5).action(async (options) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@yoqa/cli",
-	"version": "0.3.8",
+	"version": "0.3.10",
 	"description": "Yoqa CLI — drive local mobile QA from the terminal or CI (talks to the Yoqa runner over HTTP)",
 	"license": "UNLICENSED",
 	"type": "module",