autokap 1.8.7 → 1.8.9

package/dist/cli-config.js

@@ -1,15 +1,9 @@
-// CLI-local config helpers.
+// CLI-local config helpers. Self-contained, canonical implementation for the
+// bundled CLI binary.
 //
-// NOTE: this file currently duplicates the canonical implementation in
-// `@autokap/core/config`. The MCP server consumes the core package directly;
-// the bundled CLI binary still ships a self-contained copy because
-// `@autokap/core` is not yet published to npm. Once core@0.1.0 is on the
-// registry and the published CLI bumps to declare it as a runtime dep, this
-// file can become a thin re-export shim (just LOCAL_WS_URL + requireConfig).
-//
-// Hardening here must stay in lockstep with packages/core/src/config.ts:
-// atomic writes, scheme allowlist on URL inputs, env-var precedence, and
-// the "untrusted origin override" guard.
+// Security invariants to preserve when editing: atomic writes, scheme
+// allowlist on URL inputs, env-var precedence, and the "untrusted origin
+// override" guard.
 import path from 'node:path';
 import os from 'node:os';
 import crypto from 'node:crypto';
@@ -131,7 +125,8 @@ export async function writeConfig(config) {
             ? { exportDebugLogs: config.exportDebugLogs }
             : {}),
     };
-    // Atomic write — see packages/core/src/config.ts for the canonical impl.
+    // Atomic write: write to a temp file then rename, so a crash mid-write
+    // never leaves a truncated config.
     const tmpPath = `${configPath}.${process.pid}.${crypto.randomBytes(4).toString('hex')}.tmp`;
     try {
         await fs.writeFile(tmpPath, JSON.stringify(normalizedConfig, null, 2), 'utf-8');

package/dist/cli-contract.d.ts

@@ -18,15 +18,6 @@ export declare const CLI_DEFAULT_INSTALL_COMMAND = "npx -y autokap@latest";
 export declare const CLI_DEFAULT_INSTALLED_SETUP_COMMAND = "autokap login <your-api-key>";
 export declare const CLI_DEFAULT_SETUP_COMMAND = "npx -y autokap@latest login <your-api-key>";
 export declare const CLI_FALLBACK_PROGRAM_COMMAND = "autokap run <preset-id> --program <file>";
-/** Bare MCP runner. Used by generic clients and as the npx command. */
-export declare const MCP_INSTALL_COMMAND = "npx -y @autokap/mcp";
-/** One-shot install command for Claude Code (CLI flag `claude mcp add`). */
-export declare const MCP_CLAUDE_CODE_COMMAND = "claude mcp add autokap -- npx -y @autokap/mcp";
-/**
- * JSON snippet to merge into the IDE-specific MCP config file (Cursor, Codex,
- * Windsurf, Cline...). Format follows the shared `mcpServers` schema.
- */
-export declare const MCP_CONFIG_SNIPPET_JSON: string;
 export declare function buildCliRunCommand(presetId: string, options?: {
     local?: boolean;
     env?: string;

package/dist/cli-contract.js

@@ -8,47 +8,20 @@ export const CLI_KEY_TERM = API_KEY_TERM;
 export const CLI_VERSION_HEADER = "x-autokap-cli-version";
 export const MIN_CLI_VERSION_FOR_SIGNED_PROGRAMS = "1.0.9";
 export const MIN_CLI_VERSION_FOR_DIRECT_ARTIFACT_UPLOADS = "1.5.0";
-// MCP-first install. The bundled CLI binary ships only for CI / Cloud Run;
-// recommend `npx -y autokap@latest` over a global install to keep version
-// drift contained and avoid the npm supply-chain anxiety the migration was
-// designed to remove. The `CLI_DEFAULT_INSTALL_COMMAND` alias is retained for
-// legacy doc surfaces that still want a single shell snippet.
+// The bundled CLI binary ships for CI / Cloud Run and for running preset
+// captures locally; recommend `npx -y autokap@latest` over a global install to
+// keep version drift contained. The `CLI_DEFAULT_INSTALL_COMMAND` alias is the
+// single shell snippet doc surfaces reference.
 export const CLI_DEFAULT_INSTALL_COMMAND = "npx -y autokap@latest";
 // `autokap init` was removed in v2. The setup command now uses the surviving
 // `autokap login` for the same purpose (store the API key in ~/.autokap/config.json).
-// MCP-first workflows should use `autokap_authenticate` from the IDE instead.
 export const CLI_DEFAULT_INSTALLED_SETUP_COMMAND = "autokap login <your-api-key>";
 export const CLI_DEFAULT_SETUP_COMMAND = "npx -y autokap@latest login <your-api-key>";
-// `autokap skill --agent` was removed in v2. The skill ships as the MCP resource
-// `autokap://skill/preset-spec` (or `autokap_get_skill` tool fallback). The
-// legacy `CLI_ADVANCED_SKILL_COMMAND` constant that pointed at the removed
-// command was dropped entirely — it had no consumers and any future doc page
-// surfacing it would mislead users into typing a non-existent command.
+// `autokap skill --agent` was removed in v2. The legacy `CLI_ADVANCED_SKILL_COMMAND`
+// constant that pointed at the removed command was dropped entirely — it had no
+// consumers and any future doc page surfacing it would mislead users into typing
+// a non-existent command.
 export const CLI_FALLBACK_PROGRAM_COMMAND = "autokap run <preset-id> --program <file>";
-// ── MCP-first install contract ──────────────────────────────────────
-//
-// AutoKap is primarily exposed as a Model Context Protocol server via the
-// `@autokap/mcp` package. Every supported IDE installs the server by adding a
-// single stdio entry that runs `npx -y @autokap/mcp` — the constants below
-// are the canonical shell forms used across onboarding surfaces (wizard,
-// modal, banner, docs). For per-IDE payloads (config paths, snippets, notes),
-// use `getMcpInstallEntries()` from `web/lib/site-discovery.ts`.
-/** Bare MCP runner. Used by generic clients and as the npx command. */
-export const MCP_INSTALL_COMMAND = "npx -y @autokap/mcp";
-/** One-shot install command for Claude Code (CLI flag `claude mcp add`). */
-export const MCP_CLAUDE_CODE_COMMAND = "claude mcp add autokap -- npx -y @autokap/mcp";
-/**
- * JSON snippet to merge into the IDE-specific MCP config file (Cursor, Codex,
- * Windsurf, Cline...). Format follows the shared `mcpServers` schema.
- */
-export const MCP_CONFIG_SNIPPET_JSON = JSON.stringify({
-    mcpServers: {
-        autokap: {
-            command: "npx",
-            args: ["-y", "@autokap/mcp"],
-        },
-    },
-}, null, 2);
 export function buildCliRunCommand(presetId, options = {}) {
     const flags = [
         options.local ? " --local" : "",
@@ -65,19 +38,19 @@ export const CLI_PUBLIC_COMMANDS = [
     {
         id: "login",
         command: "autokap login <key>",
-        summary: "Authenticate with your API key (used by Cloud Run + CI; from the IDE, call autokap_authenticate via MCP instead)",
+        summary: "Authenticate with your API key (used by Cloud Run + CI and for local preset runs)",
         docsDescriptionKey: "cliCmdLogin",
     },
     {
         id: "run",
         command: "autokap run <preset-id> --env local",
-        summary: "Run a preset capture using local Playwright (also spawned by autokap_start_capture from the MCP server)",
+        summary: "Run a preset capture using local Playwright",
         docsDescriptionKey: "cliCmdRun",
     },
     {
         id: "auto-recapture",
         command: "autokap auto-recapture --project <project-id> --env local",
-        summary: "Run every preset enabled for Recapture Cloud in a project (the canonical surface for Cloud Run + CI; MCP exposes autokap_start_auto_recapture for end users)",
+        summary: "Run every preset enabled for Recapture Cloud in a project (the canonical surface for Cloud Run + CI)",
         docsDescriptionKey: "cliCmdAutoRecapture",
     },
     {

package/dist/cli-runner.d.ts

@@ -58,3 +58,4 @@ export interface CLIRunResult {
 }
 export declare function runCapture(options: CLIRunnerOptions): Promise<CLIRunResult>;
 export declare function buildVideoClipMetadata(videoId: string, result: RunResult, program?: ExecutionProgram, runId?: string): VideoClipMetadata[];
+export declare function resolveEffectiveCliArtifactPlan(artifactPlan: ExecutionProgram['artifactPlan'], deviceFrame?: string | null): ExecutionProgram['artifactPlan'];

package/dist/cli-runner.js

@@ -25,7 +25,7 @@ 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, seedDeviceConfigs } from './mockup.js';
+import { applyDeviceFrame, resolveVariantFrameOptions, seedDeviceConfigs } from './mockup.js';
 import { transformBrowserUrl } from './transform-browser-url.js';
 import { localizeStatusBar } from './status-bar-l10n.js';
 import { logger } from './logger.js';
@@ -164,7 +164,12 @@ export async function runCapture(options) {
     catch (error) {
         return { success: false, runId, error: error instanceof Error ? error.message : String(error) };
     }
-    if (!options.program && program.mediaMode === 'video') {
+    // TTS synthesis is real, billed work — it belongs to a real run only. A dry run validates
+    // navigation/opcodes (capture opcodes + upload are skipped below) and must NOT synthesize speech:
+    // doing so would bill TTS credits while the run reports "0 credits charged". The rewritten SLEEP
+    // durations + audio assets are only consumed on the upload path (signalVideoComplete), which a dry
+    // run never reaches, so skipping prep here is side-effect-free for dry.
+    if (!options.dryRun && !options.program && program.mediaMode === 'video') {
         const prepareResult = await prepareVideoSpeechForRun(config, options.presetId, runId, options.regenerateTts ?? false);
         if (!prepareResult.success) {
             return { success: false, runId, error: prepareResult.error };
@@ -962,6 +967,9 @@ async function uploadArtifactMultipart(config, program, runId, job, filename, pr
     if (variantSpec?.deviceFrame) {
         formData.append('deviceFrame', variantSpec.deviceFrame);
     }
+    if (variantSpec?.mockupOptions) {
+        formData.append('mockupOptions', JSON.stringify(variantSpec.mockupOptions));
+    }
     const requestedDeviceScaleFactor = variantSpec?.deviceScaleFactor ?? program.outputScale ?? 2;
     const isFrameCapture = artifact.mediaMode === 'clip' || artifact.mediaMode === 'video';
     const deviceScaleFactor = isFrameCapture && Number.isFinite(requestedDeviceScaleFactor)
@@ -1103,22 +1111,24 @@ async function prepareDirectUploadParts(params) {
 async function prepareScreenshotBufferForDirectUpload(input, metadata, program, variantSpec, tabIcon) {
     let output = input;
     const artifactPlan = resolveEffectiveCliArtifactPlan(program.artifactPlan, variantSpec?.deviceFrame ?? null);
-    if (artifactPlan?.applyStatusBar && !artifactPlan?.applyMockup) {
-        throw new Error('applyStatusBar requires applyMockup with a device frame');
-    }
-    if (artifactPlan?.applyMockup) {
-        if (!variantSpec?.deviceFrame) {
-            throw new Error('applyMockup requires a deviceFrame on the variant');
-        }
-        output = await applyDeviceFrame(output, variantSpec.deviceFrame, {
+    // The variant's deviceFrame is the sole gate. Its mockupOptions (orientation, status bar,
+    // safe areas, …) — defined by the user on the preset — drive the frame; the legacy
+    // program-level applyStatusBar only survives as a fallback for old programs without options.
+    if (variantSpec?.deviceFrame) {
+        const mockup = variantSpec.mockupOptions;
+        const frame = resolveVariantFrameOptions(mockup, {
             orientation: inferCliOrientation(metadata.viewport ?? null),
+            showStatusBar: artifactPlan?.applyStatusBar,
+        });
+        output = await applyDeviceFrame(output, variantSpec.deviceFrame, {
+            ...mockup,
+            ...frame,
             viewport: metadata.viewport ?? undefined,
             colorScheme: metadata.theme,
             outputScale: normalizeCliDeviceScaleFactor(metadata.deviceScaleFactor)
                 ?? normalizeCliDeviceScaleFactor(program.outputScale)
                 ?? 2,
-            showStatusBar: artifactPlan.applyStatusBar ?? false,
-            statusBar: localizeStatusBar({}, metadata.lang),
+            statusBar: localizeStatusBar(mockup?.statusBar ?? {}, metadata.lang),
             browserBar: buildCliBrowserBar(metadata.captureUrl, metadata.theme, tabIcon, { publicUrl: program.publicUrl, pageTitle: metadata.pageTitle ?? null }),
         });
     }
@@ -1181,10 +1191,11 @@ async function prepareClipBuffersForDirectUpload(artifact, metadata) {
         await fs.rm(tempDir, { recursive: true, force: true }).catch(() => undefined);
     }
 }
-function resolveEffectiveCliArtifactPlan(artifactPlan, deviceFrame) {
+export function resolveEffectiveCliArtifactPlan(artifactPlan, deviceFrame) {
+    // Device mockups are gated SOLELY by the variant's `deviceFrame` (user-defined, deterministic).
+    // A present deviceFrame always renders its frame; `applyMockup` is a derived value, never a
+    // kill-switch (the legacy `applyMockup: false` toggle is intentionally ignored here).
     if (deviceFrame) {
-        if (artifactPlan.applyMockup === false)
-            return artifactPlan;
         return artifactPlan.applyMockup ? artifactPlan : { ...artifactPlan, applyMockup: true };
     }
     if (!artifactPlan.applyMockup && !artifactPlan.applyStatusBar)

package/dist/cli.js

@@ -120,9 +120,9 @@ program
     logger.success(`Authenticated. Key stored in ${getConfigPath()}`);
     process.exit(0);
 });
-// Auth commands (whoami / logout / ping) live in @autokap/mcp; this binary keeps
-// `login` only for CI / Cloud Run. Local dev can still inspect the config via
-// `autokap doctor` or `cat ~/.autokap/config.json`.
+// This binary keeps `login` only for CI / Cloud Run and local preset runs.
+// Local dev can still inspect the config via `autokap doctor` or
+// `cat ~/.autokap/config.json`.
 async function runOutdatedPresetsLocally(opts) {
     if (opts.output) {
         fatal('`--output` is not supported with `--outdated`; run an individual preset when local copies are needed.');
@@ -511,10 +511,10 @@ program
     });
     process.exit(0);
 });
-// Project, preset, capture, usage, video, auth, endpoints, skill, init, proxy,
-// and branding workflows live in @autokap/mcp. This binary exposes only the
-// commands needed by CI and Cloud Run (login / run / auto-recapture / doctor).
-// See MIGRATION-v1-to-v2.md for the CLI→MCP tool mapping (kept for older users).
+// Project, preset, capture, usage, video, endpoints, proxy, and branding
+// workflows are managed from the AutoKap web dashboard and GitHub PR
+// generation. This binary exposes only the commands needed by CI, Cloud Run,
+// and local preset runs (login / run / auto-recapture / doctor).
 // ── doctor command ──────────────────────────────────────────────────
 program
     .command('doctor')

package/dist/execution-schema.d.ts

@@ -1053,7 +1053,7 @@ export declare const VariantSpecSchema: z.ZodObject<{
             light: "light";
             dark: "dark";
         }>>;
-    }, z.core.$strict>>;
+    }, z.core.$strip>>;
 }, z.core.$strict>;
 export declare const PreconditionSpecSchema: z.ZodObject<{
     credentialsId: z.ZodOptional<z.ZodString>;
@@ -1205,7 +1205,7 @@ export declare const ExecutionProgramSchema: z.ZodObject<{
                 light: "light";
                 dark: "dark";
             }>>;
-        }, z.core.$strict>>;
+        }, z.core.$strip>>;
     }, z.core.$strict>>;
     preconditions: z.ZodObject<{
         credentialsId: z.ZodOptional<z.ZodString>;

package/dist/execution-schema.js

@@ -553,7 +553,13 @@ export const VariantSpecSchema = z.object({
             radius: z.number(),
         }).strict().optional(),
         colorScheme: z.enum(['light', 'dark']).optional(),
-    }).strict().optional(),
+        // STRIP (not strict): per-variant mockupOptions are reconciled verbatim from the preset's
+        // CaptureTarget, whose UI-side MockupOptions carries render-irrelevant keys the engine never
+        // consumes (showDock, dockScale, dockMode, userAppIcon, autoBrowserBar, viewport). Strict would
+        // make parseProgram THROW on those — stranding every Mac/browser preset at CLI fetch time.
+        // Dropping unknown keys post-parse is safe: applyDeviceFrame ignores them, and the full set
+        // stays on config.targets for the UI/preview.
+    }).optional(),
 }).strict();
 const cookieSchema = z.object({
     name: z.string().min(1),

package/dist/execution-types.d.ts

@@ -535,9 +535,16 @@ export interface ArtifactSpec {
     cursorTheme?: VideoCursorTheme;
     /** Max clip duration in seconds. Clips are trimmed if they exceed this. Default: 8. Ignored when `mediaMode='video'`. */
     maxClipDurationSec?: number;
-    /** Whether to apply device frame mockup. Default: false */
+    /**
+     * @deprecated Device mockups are gated SOLELY by a variant's `deviceFrame` (user-defined,
+     * deterministic). The render paths derive mockup application from `deviceFrame` and ignore this
+     * flag as a gate. Kept optional for back-compat with stored programs; do not author it.
+     */
     applyMockup?: boolean;
-    /** Whether to add status bar. Default: false */
+    /**
+     * @deprecated Per-variant `mockupOptions.showStatusBar` drives the status bar now. Retained only
+     * as a fallback for legacy programs that lack per-variant `mockupOptions`. Do not author it.
+     */
     applyStatusBar?: boolean;
 }
 export interface ExecutionProgram {

package/dist/mockup.d.ts

@@ -204,6 +204,19 @@ export interface MockupOptions {
         height: number;
     };
 }
+/**
+ * Resolve the two per-variant frame decisions shared by both render paths (CLI direct-upload
+ * framing and the cloud legacy-multipart route): a variant's own `mockupOptions` wins, falling
+ * back to the viewport-inferred orientation and the deprecated program-level `applyStatusBar`.
+ * Pure + exported so the precedence is tested once instead of in two duplicated call sites.
+ */
+export declare function resolveVariantFrameOptions(mockupOptions: MockupOptions | undefined, fallback: {
+    orientation?: MockupOrientation;
+    showStatusBar?: boolean;
+}): {
+    orientation?: MockupOrientation;
+    showStatusBar: boolean;
+};
 export interface ResolvedDeviceFrameDescriptor {
     id: string;
     name: string;

package/dist/mockup.js

@@ -17,6 +17,18 @@ function getSupabaseMockupConfig() {
         serviceKey: process.env.SUPABASE_SERVICE_ROLE_KEY,
     };
 }
+/**
+ * Resolve the two per-variant frame decisions shared by both render paths (CLI direct-upload
+ * framing and the cloud legacy-multipart route): a variant's own `mockupOptions` wins, falling
+ * back to the viewport-inferred orientation and the deprecated program-level `applyStatusBar`.
+ * Pure + exported so the precedence is tested once instead of in two duplicated call sites.
+ */
+export function resolveVariantFrameOptions(mockupOptions, fallback) {
+    return {
+        orientation: mockupOptions?.orientation ?? fallback.orientation,
+        showStatusBar: mockupOptions?.showStatusBar ?? fallback.showStatusBar ?? false,
+    };
+}
 const DEFAULT_MOCKUP_OPTIONS = {
     orientation: 'portrait',
     outputScale: 2,

package/dist/program-signing.d.ts

@@ -111,7 +111,7 @@ export declare const SignedExecutionProgramEnvelopeSchema: z.ZodObject<{
                     light: "light";
                     dark: "dark";
                 }>>;
-            }, z.core.$strict>>;
+            }, z.core.$strip>>;
         }, z.core.$strict>>;
         preconditions: z.ZodObject<{
             credentialsId: z.ZodOptional<z.ZodString>;

package/dist/server-credit-usage.d.ts

@@ -1,5 +1,5 @@
 import type { SupabaseClient } from '@supabase/supabase-js';
-export type CreditUsageType = 'screenshot' | 'clip' | 'video' | 'cloud_recapture' | 'ai_chat' | 'studio_creation' | 'studio_iteration' | 'error_analysis' | 'obsolescence_analysis';
+export type CreditUsageType = 'screenshot' | 'clip' | 'video' | 'cloud_recapture' | 'ai_chat' | 'studio_creation' | 'studio_iteration' | 'error_analysis' | 'obsolescence_analysis' | 'pr_generation';
 export declare function recordCreditUsage(supabase: SupabaseClient, params: {
     userId: string;
     projectId: string | null;

package/dist/skill-packaging.js

@@ -19,6 +19,7 @@ const PRESET_SKILL_SOURCE = {
         { relativePath: 'OPCODE-REFERENCE.md', title: 'Opcode Reference', anchor: 'reference-opcode-reference' },
         { relativePath: 'references/STANDARDS.md', title: 'Prompt Charter & Quality Standards', anchor: 'reference-prompt-standards' },
         { relativePath: 'references/mock-data.md', title: 'Mock Data Injection', anchor: 'reference-mock-data-injection' },
+        { relativePath: 'references/video-workflow.md', title: 'Demo Video Workflow', anchor: 'reference-demo-video-workflow' },
         { relativePath: 'references/examples.md', title: 'Complete Examples', anchor: 'reference-complete-examples' },
     ],
 };

package/dist/video-narration-schema.d.ts

@@ -130,7 +130,7 @@ export declare const VideoIngestPayloadSchema: z.ZodObject<{
                     light: "light";
                     dark: "dark";
                 }>>;
-            }, z.core.$strict>>;
+            }, z.core.$strip>>;
         }, z.core.$strict>>;
         preconditions: z.ZodObject<{
             credentialsId: z.ZodOptional<z.ZodString>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autokap",
-  "version": "1.8.7",
+  "version": "1.8.9",
   "description": "AI-powered CLI tool for capturing clean screenshots of websites",
   "type": "module",
   "main": "./dist/index.js",

package/readme.md

@@ -3,21 +3,15 @@
 AI-powered website screenshot capture across every device, language, and
 theme.
 
-This npm package (`autokap`) is the **backend** consumed by:
-
-- the AutoKap Cloud Run service that handles
-  `npx autokap auto-recapture --cloud` jobs, and
-- the official MCP server `@autokap/mcp`, which spawns the package as a
-  sub-process for local capture execution (`autokap_start_capture`).
-
-**You probably do not need to install this package directly.** Wire your
-IDE assistant to `@autokap/mcp` instead — see the per-IDE install guides
-in the repository root README and the
-[migration guide](https://github.com/autokap/autokap/blob/main/MIGRATION-v1-to-v2.md).
-
-The advanced commands `autokap login`, `autokap run`, `autokap doctor`,
-and `autokap auto-recapture` remain available for users who need a
-scriptable backend (CI/CD, custom orchestrators).
+This npm package (`autokap`) is the **backend** that runs the AutoKap capture
+engine. It is consumed by the AutoKap Cloud Run service that handles
+`npx autokap auto-recapture --cloud` jobs, by CI pipelines, and for local
+preset runs.
+
+The commands `autokap login`, `autokap run`, `autokap doctor`, and
+`autokap auto-recapture` are available for users who need a scriptable backend
+(CI/CD, custom orchestrators). Project, preset, and capture management happens
+in the AutoKap web dashboard.
 
 ## Recapture Cloud in CI/CD