Method execute

src/tools/artifacts/artifact-tools.ts:325–385

(args: z.infer<typeof LiveArgs>, ctx: ToolContext)

      captureNote = cap.note;
    }

    // Ask a vision model to critique the screenshot. We reuse the vision_analyze tool so all
    // the backend-selection + graceful "[VISION_NOT_CONFIGURED]" handling lives in one place.
    const prompt = buildReviewPrompt({ type: manifest.type, title: manifest.title, intent: args.intent });
    let visionAnswer = '';
    let sawScreenshot = false;
    if (screenshotPath) {
      try {
        const res = await this.visionFn({ imagePath: screenshotPath, prompt, ctx });
        const text = typeof res.content === 'string' ? res.content : '';
        if (res.isError || text.startsWith('[VISION_NOT_CONFIGURED]')) {
          // Vision unavailable — we can still report runtime errors, just not a visual verdict.
          visionAnswer = '';
          sawScreenshot = false;
        } else {
          // vision_analyze prefixes every answer with `[via <backend>, <n>KB]\n\n`. That pushes the
          // verdict token (LOOKS_GOOD/…) off the first line, so classifyVisionAnswer — which keys off
          // the LEADING token — would misread a clean render as `unverified` and the loop would never
          // confirm success. Strip the banner so the model's actual verdict is what gets classified.
          visionAnswer = text.replace(/^\[via [^\]]*\]\s*/, '');
          sawScreenshot = true;
        }
      } catch {
        visionAnswer = '';
        sawScreenshot = false;
      }
    }

    const report = buildReviewReport({ visionAnswer, consoleErrors, pageErrors, sawScreenshot });

    const out = formatReviewReport(manifest.id, version, report);
    const notes: string[] = [];
    if (captureNote) notes.push(captureNote);
    if (!sawScreenshot && consoleErrors.length === 0 && pageErrors.length === 0 && screenshotPath) {
      notes.push(
        'No vision backend configured — captured the render but could not get a visual verdict. ' +
        'Set QODEX_OLLAMA_VISION_MODEL / ANTHROPIC_API_KEY / OPENAI_API_KEY for one.',
      );
    }
    const extra = notes.length ? '\n' + notes.map(n => `(${n})`).join('\n') : '';

    return {
      content: out + extra,
      // `issues` + `screenshotPath` are echoed so a front-end (the bot card) can render the verdict,
      // the concrete problems, and the rendered screenshot from this single tool result.
      metadata: { artifactId: manifest.id, version, verdict: report.verdict, issues: report.issues, issueCount: report.issues.length, sawScreenshot, screenshotPath, title: manifest.title, type: manifest.type },
    };
  }
}

const LiveArgs = z.object({
  id: z.string().optional().describe('The artifact id to serve live.'),
  name: z.string().optional().describe('Alias for id — some models pass the artifact title here; id takes precedence.'),
  share: z.enum(['local', 'network', 'tunnel']).optional().describe(
    'Reach: "local" (default, localhost only) · "network" (same WiFi/LAN — teammates open ' +
    'http://<your-ip>:port) · "tunnel" (a public https link via cloudflared/ngrok, plus LAN). ' +
    'network/tunnel links carry a private access token, so only someone with the full URL gets in.'),
  open: z.boolean().optional().describe(