autokap 1.6.1 → 1.6.3

package/dist/cli-doctor.js

@@ -1,21 +1,11 @@
 import { spawn } from 'node:child_process';
 import fs from 'node:fs/promises';
-import path from 'node:path';
 import chalk from 'chalk';
 import { chromium } from 'playwright';
 import { logger } from './logger.js';
 import { ensureFfmpegAvailable } from './clip-postprocess.js';
 import { readConfig, getConfigPath } from './cli-config.js';
-import { getCachedOrFetchLatest, isNewerVersion } from './version-check.js';
-import { writeSkillExport } from './skill-packaging.js';
 const REQUIRED_NODE_MAJOR = 20;
-const AGENT_PATHS = {
-    claude: '.claude/commands/autokap-preset.md',
-    codex: '.agents/skills/autokap-preset/SKILL.md',
-    cursor: '.cursor/rules/autokap-preset.md',
-    windsurf: '.windsurf/rules/autokap-preset.md',
-    copilot: '.github/instructions/autokap-preset.instructions.md',
-};
 async function pathExists(candidate) {
     try {
         await fs.access(candidate);
@@ -108,7 +98,7 @@ async function checkConfig() {
             name: 'CLI configuration',
             status: 'fail',
             message: `Failed to read config: ${err.message}`,
-            fixCommand: 'autokap init --cli-key <key>',
+            fixCommand: 'autokap login <key> # or call autokap_authenticate via your MCP-enabled IDE',
         };
     }
     if (!config) {
@@ -116,7 +106,7 @@ async function checkConfig() {
             name: 'CLI configuration',
             status: 'fail',
             message: `No API key found. Checked AUTOKAP_RUN_TOKEN, AUTOKAP_API_KEY, and ${getConfigPath()}.`,
-            fixCommand: 'autokap init --cli-key <key>',
+            fixCommand: 'autokap login <key> # or call autokap_authenticate via your MCP-enabled IDE',
         };
     }
     if (!config.apiKey) {
@@ -124,7 +114,7 @@ async function checkConfig() {
             name: 'CLI configuration',
             status: 'fail',
             message: 'Config exists but apiKey is empty.',
-            fixCommand: 'autokap init --cli-key <key>',
+            fixCommand: 'autokap login <key>',
         };
     }
     return {
@@ -133,76 +123,55 @@ async function checkConfig() {
         message: `apiBaseUrl=${config.apiBaseUrl}`,
     };
 }
-async function detectAgent() {
-    const detectors = [
-        ['.claude', 'claude'],
-        ['.agents', 'codex'],
-        ['.cursor', 'cursor'],
-        ['.windsurf', 'windsurf'],
-        ['.github/instructions', 'copilot'],
-    ];
-    for (const [dir, key] of detectors) {
-        if (await pathExists(path.join(process.cwd(), dir))) {
-            return key;
-        }
+async function checkCliKeyValid() {
+    let config = null;
+    try {
+        config = await readConfig();
     }
-    return null;
-}
-async function checkSkill(agentOverride) {
-    const agent = agentOverride ?? (await detectAgent());
-    if (!agent) {
-        return {
-            name: 'AI agent skill',
-            status: 'warn',
-            message: 'No agent directory detected (.claude, .agents, .cursor, .windsurf, .github/instructions). Skipping skill check.',
-            fixCommand: 'autokap init  # or autokap skill --agent <name> to install',
-        };
+    catch {
+        config = null;
     }
-    const skillPath = path.join(process.cwd(), AGENT_PATHS[agent]);
-    if (await pathExists(skillPath)) {
+    if (!config || !config.apiKey) {
         return {
-            name: 'AI agent skill',
-            status: 'ok',
-            message: `${agent}: ${AGENT_PATHS[agent]}`,
+            name: 'API key valid',
+            status: 'warn',
+            message: 'No API key configured locally — skipping remote validation.',
+            fixCommand: 'autokap login <key> # or call autokap_authenticate via your MCP-enabled IDE',
         };
     }
-    return {
-        name: 'AI agent skill',
-        status: 'warn',
-        message: `${agent} agent detected but skill is missing at ${AGENT_PATHS[agent]}.`,
-        fixCommand: `autokap skill --agent ${agent}`,
-        fixFn: async () => {
-            await writeSkillExport({
-                type: 'preset',
-                agent,
-                outputPath: AGENT_PATHS[agent],
-                placeholders: {},
-            });
-        },
-    };
-}
-async function checkCliVersion(currentVersion) {
-    const latest = await getCachedOrFetchLatest();
-    if (!latest) {
+    try {
+        const res = await fetch(`${config.apiBaseUrl}/api/cli/validate`, {
+            headers: { Authorization: `Bearer ${config.apiKey}` },
+            signal: AbortSignal.timeout(15_000),
+        });
+        if (res.ok) {
+            return {
+                name: 'API key valid',
+                status: 'ok',
+                message: `Key validated against ${config.apiBaseUrl}.`,
+            };
+        }
+        if (res.status === 401 || res.status === 403) {
+            return {
+                name: 'API key valid',
+                status: 'fail',
+                message: `Server rejected the API key (HTTP ${res.status}). It was likely revoked or rotated.`,
+                fixCommand: 'autokap login <new-key>',
+            };
+        }
         return {
-            name: 'CLI version',
+            name: 'API key valid',
             status: 'warn',
-            message: `${currentVersion} (latest version check unavailable — offline?)`,
+            message: `Validation endpoint returned HTTP ${res.status}.`,
         };
     }
-    if (isNewerVersion(latest, currentVersion)) {
+    catch (err) {
         return {
-            name: 'CLI version',
+            name: 'API key valid',
             status: 'warn',
-            message: `${currentVersion} installed, ${latest} available.`,
-            fixCommand: 'npm install -g autokap@latest',
+            message: `Cannot reach validation endpoint: ${err.message}`,
         };
     }
-    return {
-        name: 'CLI version',
-        status: 'ok',
-        message: `${currentVersion} (latest)`,
-    };
 }
 function runCommandStreaming(command, args) {
     return new Promise((resolve, reject) => {
@@ -247,28 +216,44 @@ function printCheck(result) {
     }
     console.log('');
 }
+function buildJsonReport(results, currentVersion) {
+    const ok = results.filter(r => r.status === 'ok').length;
+    const warn = results.filter(r => r.status === 'warn').length;
+    const fail = results.filter(r => r.status === 'fail').length;
+    return {
+        cli_version: currentVersion,
+        checks: results.map(r => ({
+            name: r.name,
+            status: r.status,
+            message: r.message,
+            fixable: Boolean(r.fixFn),
+            fix_command: r.fixCommand ?? null,
+        })),
+        summary: { ok, warn, fail, all_ok: fail === 0 && warn === 0 },
+    };
+}
 export async function runDoctor(opts, currentVersion) {
-    const agentOverride = opts.agent
-        ? opts.agent.toLowerCase()
-        : undefined;
-    if (agentOverride && !(agentOverride in AGENT_PATHS)) {
-        logger.error(`Unknown agent "${opts.agent}". Supported: ${Object.keys(AGENT_PATHS).join(', ')}`);
-        process.exit(1);
+    const jsonMode = Boolean(opts.json);
+    if (!jsonMode) {
+        console.log(chalk.bold('\nautokap doctor'));
+        console.log(chalk.gray(`Checking environment for autokap ${currentVersion}...\n`));
     }
-    console.log(chalk.bold('\nautokap doctor'));
-    console.log(chalk.gray(`Checking environment for autokap ${currentVersion}...\n`));
     const results = [];
     results.push(checkNodeVersion());
     results.push(await checkChromium());
     results.push(await checkFfmpeg());
     results.push(await checkConfig());
-    results.push(await checkSkill(agentOverride));
-    results.push(await checkCliVersion(currentVersion));
+    results.push(await checkCliKeyValid());
+    const failures = results.filter(r => r.status === 'fail');
+    const warnings = results.filter(r => r.status === 'warn');
+    if (jsonMode) {
+        const report = buildJsonReport(results, currentVersion);
+        process.stdout.write(JSON.stringify(report, null, 2) + '\n');
+        process.exit(failures.length > 0 ? 1 : 0);
+    }
     for (const r of results) {
         printCheck(r);
     }
-    const failures = results.filter(r => r.status === 'fail');
-    const warnings = results.filter(r => r.status === 'warn');
     if (opts.fix) {
         const fixable = results.filter(r => r.status !== 'ok' && r.fixFn);
         if (fixable.length === 0) {

package/dist/cli-runner.d.ts

@@ -3,7 +3,7 @@
  *
  * Entry point for deterministic execution from the CLI.
  * Flow:
- * 1. Authenticate via stored CLI key
+ * 1. Authenticate via stored API key
  * 2. Fetch compiled program from server
  * 3. Validate program against Zod schema
  * 4. Launch local Playwright browser per variant

package/dist/cli-runner.js

@@ -3,7 +3,7 @@
  *
  * Entry point for deterministic execution from the CLI.
  * Flow:
- * 1. Authenticate via stored CLI key
+ * 1. Authenticate via stored API key
  * 2. Fetch compiled program from server
  * 3. Validate program against Zod schema
  * 4. Launch local Playwright browser per variant
@@ -25,7 +25,8 @@ import { parseProgram } from './execution-schema.js';
 import { buildCursorOverlayScript } from './cursor-overlay-script.js';
 import { CLI_VERSION_HEADER, } from './cli-contract.js';
 import { postProcessClipRecording } from './clip-postprocess.js';
-import { applyDeviceFrame } from './mockup.js';
+import { applyDeviceFrame, seedDeviceConfigs } from './mockup.js';
+import { transformBrowserUrl } from './transform-browser-url.js';
 import { localizeStatusBar } from './status-bar-l10n.js';
 import { logger } from './logger.js';
 import { callLLM } from './llm-provider.js';
@@ -166,6 +167,11 @@ export async function runCapture(options) {
             presetId: options.presetId,
         };
     }
+    // Custom device frames live in Supabase (table `device_mockups`) and the
+    // end-user CLI does not have the service role key. The server pre-fetches
+    // every device referenced by `variants[].deviceFrame` and embeds the rows
+    // here; we seed mockup.ts so the export pipeline can apply them locally.
+    seedDeviceConfigs(program.deviceConfigs ?? null);
     const runId = randomUUID();
     let videoAudioAssets;
     let videoAudioAssetsByLocale;
@@ -248,6 +254,7 @@ export async function runCapture(options) {
             lang: variant.locale,
             colorScheme: variant.theme,
             storageState: program.preconditions.storageState,
+            extraHttpHeaders: program.environmentHttpHeaders,
         };
         let recordingDir;
         let browser;
@@ -884,6 +891,9 @@ async function uploadArtifactMultipart(config, program, runId, job, filename) {
     formData.append('mimeType', artifact.mimeType);
     formData.append('captureType', artifact.captureType ?? 'fullpage');
     formData.append('captureUrl', artifact.captureUrl ?? program.baseUrl);
+    if (artifact.pageTitle) {
+        formData.append('pageTitle', artifact.pageTitle);
+    }
     formData.append('lang', variantSpec?.locale ?? 'en');
     formData.append('theme', variantSpec?.theme ?? 'light');
     if (variantSpec?.deviceFrame) {
@@ -961,6 +971,7 @@ async function prepareDirectArtifactUpload(params) {
         mimeType: artifact.mimeType,
         captureType: artifact.captureType ?? 'fullpage',
         captureUrl: artifact.captureUrl ?? program.baseUrl,
+        pageTitle: artifact.pageTitle ?? null,
         lang: variantSpec?.locale ?? 'en',
         theme: variantSpec?.theme ?? 'light',
         deviceFrame: variantSpec?.deviceFrame ?? null,
@@ -1039,7 +1050,7 @@ async function prepareScreenshotBufferForDirectUpload(input, metadata, program,
                 ?? 2,
             showStatusBar: artifactPlan.applyStatusBar ?? false,
             statusBar: localizeStatusBar({}, metadata.lang),
-            browserBar: buildCliBrowserBar(metadata.captureUrl, metadata.theme, tabIcon),
+            browserBar: buildCliBrowserBar(metadata.captureUrl, metadata.theme, tabIcon, { publicUrl: program.publicUrl, pageTitle: metadata.pageTitle ?? null }),
         });
     }
     if (artifactPlan?.format?.screenshotFormat === 'jpeg') {
@@ -1122,14 +1133,16 @@ function normalizeCliDeviceScaleFactor(value) {
         return null;
     return Math.max(0.5, Math.min(4, Number(value)));
 }
-function buildCliBrowserBar(captureUrl, colorScheme, tabIcon) {
+function buildCliBrowserBar(captureUrl, colorScheme, tabIcon, options = {}) {
     if (!captureUrl)
         return undefined;
+    const displayUrl = transformBrowserUrl(captureUrl, options.publicUrl);
+    const explicitTitle = options.pageTitle?.trim() || null;
     try {
-        const parsed = new URL(captureUrl);
+        const parsed = new URL(displayUrl);
         return {
-            url: captureUrl,
-            pageTitle: parsed.hostname,
+            url: displayUrl,
+            pageTitle: explicitTitle ?? parsed.hostname,
             colorScheme,
             tabIconUrl: tabIcon
                 ? `data:${tabIcon.mimeType};base64,${tabIcon.buffer.toString('base64')}`
@@ -1138,8 +1151,8 @@ function buildCliBrowserBar(captureUrl, colorScheme, tabIcon) {
     }
     catch {
         return {
-            url: captureUrl,
-            pageTitle: captureUrl,
+            url: displayUrl,
+            pageTitle: explicitTitle ?? displayUrl,
             colorScheme,
             ...(tabIcon
                 ? { tabIconUrl: `data:${tabIcon.mimeType};base64,${tabIcon.buffer.toString('base64')}` }
@@ -1230,7 +1243,7 @@ async function formatServerError(response, requestedUrl) {
             `server returned 404 for ${requestedUrl}.`,
             `The configured AutoKap server (${safeOrigin(requestedUrl)}) does not expose this CLI route yet.`,
             'This usually means the web app deployment is older than the CLI.',
-            `Point the CLI at your local dev server with \`autokap run --local <preset-id>\`, \`${API_BASE_URL_ENV_VAR}=http://localhost:3000 autokap run <preset-id>\`, or re-initialize against a local server with \`autokap init --cli-key <key> --api-base-url http://localhost:3000\`.`,
+            `Point the CLI at your local dev server with \`autokap run --local <preset-id>\`, \`${API_BASE_URL_ENV_VAR}=http://localhost:3000 autokap run <preset-id>\`, or re-authenticate via your IDE's MCP integration (autokap_authenticate). From CI, set \`${API_BASE_URL_ENV_VAR}=http://localhost:3000\` and run \`autokap login <key>\`.`,
         ].join(' ');
     }
     if (isHtml) {