@vostride/agent-qa-dashboard 0.1.9 → 0.1.10

package/dist/server/index.cjs

@@ -5694,6 +5694,7 @@ var ConfigManager = class {
 // src/execution/appium-manager.ts
 var import_node_http = require("http");
 var import_node_child_process2 = require("child_process");
+var import_agent_qa_core7 = require("@vostride/agent-qa-core");
 var import_tree_kill2 = __toESM(require("tree-kill"), 1);
 var import_picocolors = __toESM(require("picocolors"), 1);
 var APPIUM_PREFIX = import_picocolors.default.magenta("[appium]");
@@ -5708,11 +5709,13 @@ var AppiumManager = class {
   anonymousRefCount = 0;
   leases = /* @__PURE__ */ new Map();
   logLevel;
+  appiumResolver;
   constructor(opts) {
     this.port = opts?.port ?? 4723;
     this.startupTimeoutMs = opts?.startupTimeoutMs ?? 3e4;
     this.pollIntervalMs = opts?.pollIntervalMs ?? 500;
     this.logLevel = opts?.logLevel ?? "normal";
+    this.appiumResolver = opts?.appiumResolver ?? import_agent_qa_core7.resolveAppiumExecutable;
   }
   async acquire() {
     await this.ensureRunning();
@@ -5807,14 +5810,15 @@ var AppiumManager = class {
     });
   }
   async startAndWait() {
-    const child = (0, import_node_child_process2.spawn)("appium", ["-p", String(this.port), "--relaxed-security", "--log-no-colors"], {
+    const appium = this.appiumResolver();
+    const child = (0, import_node_child_process2.spawn)(appium.command, ["-p", String(this.port), "--relaxed-security", "--log-no-colors"], {
       stdio: ["ignore", "pipe", "pipe"]
     });
     this.process = child;
     this.managed = true;
     child.on("error", (err) => {
       if (err.code === "ENOENT") {
-        console.error(`${APPIUM_PREFIX} Appium not found. Run \`npm install -g appium\` to install it.`);
+        console.error(`${APPIUM_PREFIX} Appium not found. ${(0, import_agent_qa_core7.formatAppiumInstallGuidance)()}`);
       } else {
         console.error(`${APPIUM_PREFIX} Error: ${err.message}`);
       }
@@ -5910,13 +5914,13 @@ var import_node_crypto3 = require("crypto");
 
 // src/live-editor/live-session.ts
 var import_node_crypto2 = require("crypto");
-var import_agent_qa_core8 = require("@vostride/agent-qa-core");
+var import_agent_qa_core9 = require("@vostride/agent-qa-core");
 
 // src/live-editor/mobile-bootstrap.ts
 var import_promises8 = require("fs/promises");
 var import_node_path8 = require("path");
 var import_yaml8 = require("yaml");
-var import_agent_qa_core7 = require("@vostride/agent-qa-core");
+var import_agent_qa_core8 = require("@vostride/agent-qa-core");
 async function loadLocalBindings(configPath) {
   const filePath = (0, import_node_path8.join)((0, import_node_path8.dirname)(configPath), "agent-qa.local.yaml");
   try {
@@ -5934,8 +5938,8 @@ async function loadLocalBindings(configPath) {
   }
 }
 function asMobileSetupError(err, category, message, input) {
-  if (err instanceof import_agent_qa_core7.MobileSetupError) return err;
-  return new import_agent_qa_core7.MobileSetupError({
+  if (err instanceof import_agent_qa_core8.MobileSetupError) return err;
+  return new import_agent_qa_core8.MobileSetupError({
     category,
     message: `${message}: ${err instanceof Error ? err.message : String(err)}`,
     platform: input.platform,
@@ -5945,7 +5949,7 @@ function asMobileSetupError(err, category, message, input) {
 }
 async function prepareMobileLiveSession(input) {
   if (!input.targetName) {
-    throw new import_agent_qa_core7.MobileSetupError({
+    throw new import_agent_qa_core8.MobileSetupError({
       category: "device-resolution",
       message: `No targetName provided for ${input.platform} live session`,
       platform: input.platform
@@ -5961,7 +5965,7 @@ async function prepareMobileLiveSession(input) {
   const configuredAppState = config.use?.mobile?.appState;
   let resolved;
   try {
-    resolved = (0, import_agent_qa_core7.resolveMobileRunConfig)({
+    resolved = (0, import_agent_qa_core8.resolveMobileRunConfig)({
       config,
       targetName: input.targetName,
       platform: input.platform,
@@ -5977,7 +5981,7 @@ async function prepareMobileLiveSession(input) {
   try {
     await input.appiumManager.acquireLease({ runId: input.sessionId, platform: input.platform });
   } catch (err) {
-    throw new import_agent_qa_core7.MobileSetupError({
+    throw new import_agent_qa_core8.MobileSetupError({
       category: "appium-startup",
       message: `Failed to acquire Appium for ${input.platform} live session: ${err instanceof Error ? err.message : String(err)}`,
       platform: input.platform,
@@ -6093,9 +6097,9 @@ function classifyAdapterSetupError(err) {
   return "device-readiness";
 }
 function wrapAdapterSetupError(err, platform, config) {
-  if (err instanceof import_agent_qa_core8.MobileSetupError) return err;
+  if (err instanceof import_agent_qa_core9.MobileSetupError) return err;
   const appId = platform === "android" ? config.appPackage : config.bundleId;
-  return new import_agent_qa_core8.MobileSetupError({
+  return new import_agent_qa_core9.MobileSetupError({
     category: classifyAdapterSetupError(err),
     message: `Failed to create ${platform} adapter session: ${err instanceof Error ? err.message : String(err)}`,
     platform,
@@ -6175,10 +6179,10 @@ var LiveSession = class {
     this.pendingMessages.push(message);
   }
   redact(value) {
-    return (0, import_agent_qa_core8.redactSecretValue)(value, this.secretRedactor);
+    return (0, import_agent_qa_core9.redactSecretValue)(value, this.secretRedactor);
   }
   resolveSecrets(value) {
-    return (0, import_agent_qa_core8.resolveSecretTemplatesInValue)(value, this.secretStore);
+    return (0, import_agent_qa_core9.resolveSecretTemplatesInValue)(value, this.secretStore);
   }
   emitHookStart(hookDef, phase, owner = { scope: "suite" }) {
     const hook = {
@@ -6265,7 +6269,7 @@ var LiveSession = class {
         }
         continue;
       }
-      const result = await (0, import_agent_qa_core8.runHooks)([hookDef], {
+      const result = await (0, import_agent_qa_core9.runHooks)([hookDef], {
         envVars: this.getHookEnvVars(),
         secretStore: this.secretStore,
         secretRedactor: this.secretRedactor
@@ -6375,7 +6379,7 @@ var LiveSession = class {
           adapter = new IOSPlatformAdapter();
         }
       } catch (err) {
-        throw new import_agent_qa_core8.MobileSetupError({
+        throw new import_agent_qa_core9.MobileSetupError({
           category: "adapter-load",
           message: `Failed to load ${platformLabel} adapter (@vostride/agent-qa-${platform}). Is the package installed? ${err instanceof Error ? err.message : String(err)}`,
           platform,
@@ -6397,7 +6401,7 @@ var LiveSession = class {
       } catch {
       }
       this.releaseMobileAppiumLease("setup-failed");
-      if (err instanceof import_agent_qa_core8.MobileSetupError) {
+      if (err instanceof import_agent_qa_core9.MobileSetupError) {
         throw new Error(mobileSetupMessage(err));
       }
       throw err;
@@ -6406,7 +6410,7 @@ var LiveSession = class {
   async initialize(config) {
     this.platform = config.platform;
     this._modelName = config.llmConfig.model ?? "unknown";
-    this.variableStore = new import_agent_qa_core8.VariableStore();
+    this.variableStore = new import_agent_qa_core9.VariableStore();
     this.secretStore = config.secretStore;
     this.secretRedactor = config.secretRedactor;
     if (config.envVars) {
@@ -6450,10 +6454,10 @@ var LiveSession = class {
       ...config.llmConfig,
       ...config.authFetch ? { fetch: config.authFetch } : {}
     };
-    this.model = await (0, import_agent_qa_core8.createModel)(modelConfig);
-    const providerOptions = (0, import_agent_qa_core8.getProviderOptions)(modelConfig);
-    this.planner = new import_agent_qa_core8.LLMPlanner(this.model, config.platform, providerOptions, void 0, config.agentRules);
-    this.verifier = new import_agent_qa_core8.LLMVerifier(this.model, providerOptions);
+    this.model = await (0, import_agent_qa_core9.createModel)(modelConfig);
+    const providerOptions = (0, import_agent_qa_core9.getProviderOptions)(modelConfig);
+    this.planner = new import_agent_qa_core9.LLMPlanner(this.model, config.platform, providerOptions, void 0, config.agentRules);
+    this.verifier = new import_agent_qa_core9.LLMVerifier(this.model, providerOptions);
     this.status = "idle";
     this.createdAt = Date.now();
     this.readyForInteraction = true;
@@ -6463,7 +6467,7 @@ var LiveSession = class {
     let instruction = stepInstruction;
     let hasTemplateVars = false;
     const executionLogs = [];
-    const inlineHookCalls = (0, import_agent_qa_core8.parseHookInline)(stepInstruction);
+    const inlineHookCalls = (0, import_agent_qa_core9.parseHookInline)(stepInstruction);
     if (inlineHookCalls.length > 0) {
       let inlineHookFailed = false;
       for (const call of inlineHookCalls) {
@@ -6478,7 +6482,7 @@ var LiveSession = class {
         }
         const startedAt = performance.now();
         try {
-          const result = await (0, import_agent_qa_core8.runHookInSandbox)(hookDef, {
+          const result = await (0, import_agent_qa_core9.runHookInSandbox)(hookDef, {
             envVars: this.getHookEnvVars(),
             secretStore: this.secretStore,
             secretRedactor: this.secretRedactor
@@ -6524,7 +6528,7 @@ var LiveSession = class {
           break;
         }
       }
-      instruction = (0, import_agent_qa_core8.stripHookInline)(stepInstruction);
+      instruction = (0, import_agent_qa_core9.stripHookInline)(stepInstruction);
       hasTemplateVars = true;
       if (inlineHookFailed) {
         return {
@@ -6535,7 +6539,7 @@ var LiveSession = class {
         };
       }
     }
-    instruction = (0, import_agent_qa_core8.interpolateVariables)(instruction, this.variableStore);
+    instruction = (0, import_agent_qa_core9.interpolateVariables)(instruction, this.variableStore);
     hasTemplateVars = hasTemplateVars || originalStepName !== instruction;
     const runJSMatches = parseRunJSInline(instruction);
     if (runJSMatches.length > 0) {
@@ -6662,7 +6666,7 @@ var LiveSession = class {
         this.stepsExecuted++;
         return result2;
       }
-      const unresolvedTemplates = (0, import_agent_qa_core8.findUnresolvedTemplates)(prepared.instruction);
+      const unresolvedTemplates = (0, import_agent_qa_core9.findUnresolvedTemplates)(prepared.instruction);
       if (unresolvedTemplates.length > 0) {
         const errorLines = unresolvedTemplates.map((template) => `  - ${template.pattern}: ${template.message}`);
         const error = `Unresolved template variable(s):
@@ -6704,7 +6708,7 @@ ${errorLines.join("\n")}`;
         healingConfig: { maxAttempts: 3 },
         variables: this.redact(variables)
       };
-      let result = await (0, import_agent_qa_core8.executeStep)(prepared.instruction, loopConfig, stepContext);
+      let result = await (0, import_agent_qa_core9.executeStep)(prepared.instruction, loopConfig, stepContext);
       result.originalStepName = prepared.originalStepName;
       result.variableSnapshot = this.variableStore.snapshot();
       result.executionLogs = this.redact(prepared.executionLogs);
@@ -7059,7 +7063,7 @@ var SessionManager = class {
 };
 
 // src/live-editor/ws-handler.ts
-var import_agent_qa_core9 = require("@vostride/agent-qa-core");
+var import_agent_qa_core10 = require("@vostride/agent-qa-core");
 function send(ws, msg) {
   if (ws.readyState === ws.OPEN) {
     ws.send(JSON.stringify(msg));
@@ -7227,7 +7231,7 @@ function createSessionHandler(session, onTerminate, onTokenUsage, testFileManage
               console.error(`[ws-handler] execute-test: read failed for path=${msg.path}`, readErr);
               throw new Error(`Cannot read test file "${msg.path}": ${readErr?.message ?? String(readErr)}`);
             }
-            const parsed = (0, import_agent_qa_core9.parseTestFile)(raw, msg.path);
+            const parsed = (0, import_agent_qa_core10.parseTestFile)(raw, msg.path);
             if (parsed.errors.length > 0) {
               console.error(`[ws-handler] execute-test: parse errors for ${msg.path}`, parsed.errors);
               throw new Error(`Parse error in ${msg.path}: ${parsed.errors[0].message}`);
@@ -7407,7 +7411,7 @@ function createSessionHandler(session, onTerminate, onTokenUsage, testFileManage
 }
 
 // src/server/server.ts
-var import_agent_qa_core10 = require("@vostride/agent-qa-core");
+var import_agent_qa_core11 = require("@vostride/agent-qa-core");
 var import_agent_qa_mcp = require("@vostride/agent-qa-mcp");
 var MIME_TYPES = {
   ".html": "text/html; charset=utf-8",
@@ -7826,8 +7830,8 @@ async function startServer(opts) {
   const captureMcpLifecycle = async (properties) => {
     if (isAnalyticsPrivacyEnabled(config)) return;
     try {
-      const standardProperties = await (0, import_agent_qa_core10.resolveAnalyticsStandardProperties)({ surface: "dashboard-server" });
-      await (0, import_agent_qa_core10.captureAnalytics)((0, import_agent_qa_core10.buildAnalyticsEvent)({
+      const standardProperties = await (0, import_agent_qa_core11.resolveAnalyticsStandardProperties)({ surface: "dashboard-server" });
+      await (0, import_agent_qa_core11.captureAnalytics)((0, import_agent_qa_core11.buildAnalyticsEvent)({
         name: "agent-qa.mcp.server.lifecycle",
         properties: {
           ...standardProperties,