autokap 1.1.0 → 1.1.2

package/assets/skill/OPCODE-REFERENCE.md

@@ -1,6 +1,6 @@
 # AutoKap Opcode Reference
 
-Detailed parameter documentation for all 25 opcodes. For workflow, rules, and examples, see [SKILL.md](SKILL.md).
+Detailed parameter documentation for all 23 opcodes. For workflow, rules, and examples, see [SKILL.md](SKILL.md).
 
 ## Common Fields (all opcodes)
 
@@ -375,46 +375,6 @@ Capture a screenshot of the viewport or a specific element.
 { "kind": "CAPTURE_SCREENSHOT", "captureId": "dashboard-main", "captureName": "Dashboard", "elementSelector": "[data-ak=\"main-content\"]", "postcondition": { "type": "always" } }
 ```
 
-## CAPTURE_DOM
-
-Capture a DOM snapshot for an interactive demo state.
-
-| Param | Type | Required | Description |
-|-------|------|----------|-------------|
-| `stateName` | string | yes | Stable state identifier used by the interactive demo player |
-| `selector` | string | no | CSS selector of a focused subtree to serialize instead of the whole page |
-
-**Can:** Capture the full page DOM for a state, or a focused subtree when only part of the page matters. Feed the interactive demo player with a state that can later host fragments and transitions.
-**Cannot:** Produce screenshots or clips. Use only when `mediaMode` is `dom`.
-
-**Tip:** Omit `selector` for page-level states. Add it when the interactive demo should ignore surrounding chrome and serialize only a mounted area.
-
-```json
-{ "kind": "CAPTURE_DOM", "stateName": "dashboard-default", "selector": "[data-ak=\"dashboard-shell\"]", "postcondition": { "type": "always" } }
-```
-
-## CAPTURE_FRAGMENT
-
-Capture a local DOM fragment that mounts on top of a previously captured state.
-
-| Param | Type | Required | Description |
-|-------|------|----------|-------------|
-| `fragmentName` | string | yes | Stable fragment identifier |
-| `parentState` | string | yes | Name of the CAPTURE_DOM state this fragment belongs to |
-| `selector` | string | yes | CSS selector of the fragment root to serialize |
-| `variantName` | string | no | Optional named fragment variant for in-place swaps |
-| `triggerSelector` | string | no | Selector of the element that should trigger this fragment in the player |
-| `mountStrategy` | `"replace"` \| `"append"` | no | How the player should mount the fragment relative to the parent state |
-
-**Can:** Capture modals, popovers, dropdowns, drawers, or any local subtree that should be replayed on top of a parent state. Capture multiple variants of the same fragment to enable in-place swaps in the player.
-**Cannot:** Stand alone without a `parentState`. Replace full-page routing states; use CAPTURE_DOM for those.
-
-**Tip:** Use `variantName` when the same fragment can appear in multiple visual forms, such as color/theme swaps or alternate content blocks on the same background state.
-
-```json
-{ "kind": "CAPTURE_FRAGMENT", "fragmentName": "pricing-modal", "parentState": "dashboard-default", "selector": "[data-ak=\"pricing-modal\"]", "triggerSelector": "[data-ak=\"open-pricing\"]", "mountStrategy": "append", "postcondition": { "type": "always" } }
-```
-
 ## BEGIN_CLIP
 
 Start recording a clip. All interactions between BEGIN_CLIP and END_CLIP are recorded.

package/assets/skill/README.md

@@ -8,7 +8,6 @@ Edit files here first.
 - `SKILL.md` is the core preset contract and must stay short enough to remain
   readable.
 - `references/*.md` holds longer mode-specific guidance and examples.
-- `STUDIO-SKILL.md` is the separate studio/composition skill.
 - `src/skill-packaging.ts` compiles these sources into the outputs each agent
   expects.
 

package/assets/skill/SKILL.md

@@ -2,7 +2,7 @@
 name: autokap-preset
 description: >
   Generate AutoKap capture programs — deterministic opcode sequences for automated
-  screenshot, clip, and interactive demo capture of web apps. Use when: creating or updating presets,
+  screenshot and clip capture of web apps. Use when: creating or updating presets,
   adding data-ak attributes for capture automation, or debugging failed capture programs.
 metadata:
   author: AutoKap
@@ -21,7 +21,7 @@ This installed skill is the **source of truth** for the AutoKap contract: opcode
 
 ## When To Use This Skill
 
-- User wants to capture screenshots, clips, or interactive demos of their web app
+- User wants to capture screenshots or clips of their web app
 - User asks to create or update an AutoKap preset
 - User needs `data-ak` attributes added to UI elements for capture
 - User is debugging a failed capture program
@@ -38,7 +38,7 @@ This installed skill is the **source of truth** for the AutoKap contract: opcode
 
 ## Quick Workflow
 
-1. **Understand the capture goal** — What pages/states should be captured? Screenshot, clip, or interactive demo? Which viewports, locales, themes, and mockups matter?
+1. **Understand the capture goal** — What pages/states should be captured? Screenshot or clip? Which viewports, locales, themes, and mockups matter?
 2. **Inspect the implementation** — Confirm routes, auth, theme, locale, and any dynamic UI state in the codebase.
 3. **Add `data-ak` attributes** — Tag every element the opcodes must interact with using stable selectors.
 4. **Choose media mode and variants** — Set `mediaMode` and define the exact viewport/locale/theme combinations.
@@ -52,7 +52,6 @@ This installed skill is the **source of truth** for the AutoKap contract: opcode
 Load these only when the request actually needs them:
 
 - **Opcode parameters** — [OPCODE-REFERENCE.md](OPCODE-REFERENCE.md)
-- **Interactive demos** — [references/interactive-demo.md](references/interactive-demo.md)
 - **Mock data** — [references/mock-data.md](references/mock-data.md)
 - **Complete examples** — [references/examples.md](references/examples.md)
 
@@ -91,7 +90,7 @@ For every element you interact with in the opcodes, add a `data-ak="descriptive-
 interface ExecutionProgram {
   presetId: string;         // Unique slug (e.g. "homepage-hero")
   programVersion: number;   // Always 1 for new programs
-  mediaMode: 'screenshot' | 'clip' | 'dom';
+  mediaMode: 'screenshot' | 'clip';
   baseUrl: string;          // Root URL of the application
   variants: VariantSpec[];  // Viewport/locale/theme combinations
   preconditions: {
@@ -105,7 +104,7 @@ interface ExecutionProgram {
   };
   steps: ExecutionOpcode[];
   artifactPlan: {
-    mediaMode: 'screenshot' | 'clip' | 'dom';
+    mediaMode: 'screenshot' | 'clip';
     cursorTheme?: 'minimal' | 'macos' | 'windows'; // Clip only. Default: 'minimal'
     format?: {
       clipFormat?: 'gif' | 'mp4' | 'both';      // Default: 'gif'
@@ -134,7 +133,7 @@ interface VariantSpec {
 
 ## Opcode Quick Reference
 
-25 opcodes available. For full parameter documentation, see [OPCODE-REFERENCE.md](OPCODE-REFERENCE.md).
+23 opcodes available. For full parameter documentation, see [OPCODE-REFERENCE.md](OPCODE-REFERENCE.md).
 
 | Kind | Selector? | Key Params | Typical Postcondition | Notes |
 |------|-----------|-----------|----------------------|-------|
@@ -155,8 +154,6 @@ interface VariantSpec {
 | `ASSERT_ROUTE` | no | `urlPattern` | `route_matches` | Validation checkpoint |
 | `ASSERT_SURFACE` | no | `selectors[]`, `matchAll` | `always` | Validation checkpoint |
 | `CAPTURE_SCREENSHOT` | no | `captureId`, `captureName`, `elementSelector?` | `always` | `elementSelector` for element-level crop |
-| `CAPTURE_DOM` | no | `stateName`, `selector?` | `always` | Interactive Demo state — see [Interactive Demo Workflow](#interactive-demo-workflow). `mediaMode: "dom"` only. Add `selector` to capture a focused subtree instead of the whole page. |
-| `CAPTURE_FRAGMENT` | yes | `fragmentName`, `parentState`, `selector`, `variantName?`, `triggerSelector?`, `mountStrategy?` | `always` | Interactive Demo fragment (modal/popover/dropdown/local subtree) — see [Fragments](#fragments-and-local-interactions). Mounted on top of `parentState` by the player. Capture the same fragment under multiple `variantName`s to enable in-place swap (e.g. background colour change). |
 | `BEGIN_CLIP` | no | `clipId`, `clipName` | `always` | Start recording |
 | `END_CLIP` | no | `clipId`, `clipName` | `always` | Stop recording. Same `clipId` as BEGIN_CLIP |
 | `CLONE_ELEMENT` | yes | `sourceSelector`, `containerSelector`, `count` | `always` | **Non-blocking.** Duplicate a template element N times |
@@ -284,25 +281,6 @@ Place this step **after** DISMISS_OVERLAYS + any content WAIT_FOR, and **immedia
 }
 ```
 
-## Interactive Demo Workflow
-
-Interactive demos are advanced and should only be used when the user wants a
-clickable DOM-based experience, not static screenshots or a clip.
-
-Key rules:
-
-- center the capture around the feature loop, not the whole app
-- use `CAPTURE_DOM` for base states
-- use `CAPTURE_FRAGMENT` for local overlays and subtree swaps
-- add authored markers such as `data-ak-interact`, `data-ak-fragment`,
-  `data-ak-model`, and `data-ak-template`
-- prefer fragments / bindings / model-driven reconstruction before custom
-  interaction `code`
-
-Read the full reference before generating an interactive demo:
-
-- [references/interactive-demo.md](references/interactive-demo.md)
-
 ## Recovery System Overview
 
 When an opcode fails, AutoKap tries 5 recovery strategies in order:
@@ -358,7 +336,7 @@ Read the full reference before adding mock data:
 4. **CLICK postconditions describe the result**, not the action (what changed, not what was clicked)
 5. **Add `WAIT_FOR` after page transitions** (login, route change, modal open)
 6. **Set `waitMs: 10000`** on postconditions involving async transitions
-7. **Persist the preset via the CLI — the program lives INSIDE `config.program`**, not in a separate file. After generating the program JSON, write the full config to a temp file and run `autokap preset create` or `autokap preset update` so the saved preset contains `program: { ...the full ExecutionProgram... }` plus any `interactiveDemo` / `mockDataInjection` blocks. The user MUST be able to run `autokap run <preset-id>` afterwards with no `--program` flag and no extra files. **Never tell the user to save the JSON to a local file**, never suggest `--program <file>` as the normal run path. The CLI fetches the program from the server.
+7. **Persist the preset via the CLI — the program lives INSIDE `config.program`**, not in a separate file. After generating the program JSON, write the full config to a temp file and run `autokap preset create` or `autokap preset update` so the saved preset contains `program: { ...the full ExecutionProgram... }` plus any `mockDataInjection` blocks. The user MUST be able to run `autokap run <preset-id>` afterwards with no `--program` flag and no extra files. **Never tell the user to save the JSON to a local file**, never suggest `--program <file>` as the normal run path. The CLI fetches the program from the server.
 8. **Use `captureId`/`clipId`** on CAPTURE_SCREENSHOT/BEGIN_CLIP for Studio and dev links to work. Always set `"devLinksEnabled": true` in the preset config when creating via API so endpoints are visible on the dashboard
 9. **Mock data opcodes are non-blocking** — they log a warning and continue if selectors miss; always pair them with `recovery: { retries: 0, ... }` and `postcondition: { type: "always" }`
 10. **Hardcode the login URL — never use `{{loginUrl}}`.** The login URL is just another navigation. You generate the entire program, so you know which path the app's login lives at — write it directly (`https://app.example.com/login`, `http://localhost:3000/login`, etc.). The `{{loginUrl}}` placeholder is **deprecated** and produces broken navigations when the user hasn't filled the optional `loginUrl` credential field. `{{email}}` and `{{password}}` placeholders for `TYPE` opcodes are still correct and required (those are sensitive secrets the user fills in).
@@ -408,7 +386,7 @@ Use the AutoKap CLI commands to create, update, and query presets. The CLI reads
 
 ### Step 1: Write the config JSON to a temp file
 
-Build the full config object (with `program`, `pages`, and optionally `interactiveDemo`/`mockDataInjection`) and write it to a temporary file:
+Build the full config object (with `program`, `pages`, and optionally `mockDataInjection`) and write it to a temporary file:
 
 ```bash
 cat > /tmp/autokap-preset.json << 'EOF'
@@ -441,7 +419,7 @@ EOF
 - **`pages`** — one entry per `CAPTURE_SCREENSHOT` opcode (`{ "id": "<captureId>", "name": "<captureName>" }`). Drives endpoint (dev link) creation. **Screenshot presets only.**
 - **`clips`** — one entry per `BEGIN_CLIP`/`END_CLIP` pair (`{ "id": "<clipId>", "name": "<clipName>" }`). Drives endpoint and Studio slot creation. **Clip presets only.** Do NOT put clip entries in `pages` — the server treats `pages` as screenshots.
 - **`program`** — the full `ExecutionProgram` with `steps`, `variants`, `artifactPlan`, etc.
-- **`captureMode`** — `"screenshot"`, `"clip"`, or `"interactive_demo"`.
+- **`captureMode`** — `"screenshot"` or `"clip"`.
 - **`devLinksEnabled: true`** — enables endpoints on the dashboard.
 
 The server auto-syncs `langs`, `themes`, `targets`, and `viewports` from `program.variants` — you do NOT need to set these manually.
@@ -553,7 +531,6 @@ Use the examples reference for ready-made shapes of:
 - anonymous screenshot presets
 - authenticated screenshot presets
 - clip presets
-- interactive demo presets
 - mock-data-enabled presets
 
 Read:

package/assets/skill/references/examples.md

@@ -59,23 +59,7 @@ Pattern:
 
 Prefer short, deterministic flows.
 
-## Example 4 — Interactive demo preset
-
-Good for:
-
-- embeddable product demos
-- focused feature loops
-- local UI swaps and fragment-driven demos
-
-Pattern:
-
-1. `mediaMode: "dom"`
-2. capture a small number of base states with `CAPTURE_DOM`
-3. capture overlays/local subtrees with `CAPTURE_FRAGMENT`
-4. wire `interactiveDemo.script`
-5. use fragments, model bindings, and small `code` blocks for reconstruction
-
-## Example 5 — Mock data preset
+## Example 4 — Mock data preset
 
 Good for:
 

package/dist/billing-operation-logging.d.ts

@@ -1,6 +1,6 @@
 import type { SupabaseClient } from '@supabase/supabase-js';
 import type { StepUsage } from './types.js';
-export type BillingOperationType = 'screenshot' | 'clip' | 'interactive_demo';
+export type BillingOperationType = 'screenshot' | 'clip';
 type BillingOperationOutcome = 'succeeded' | 'failed' | 'cancelled';
 interface BillingOperationContext {
     runId: string;
@@ -10,7 +10,6 @@ interface BillingOperationContext {
     captureId?: string | null;
     videoId?: string | null;
     clipRecordId?: string | null;
-    interactiveDemoStateId?: string | null;
     operationType: BillingOperationType;
     captureType?: 'fullpage' | 'element' | null;
     lang?: string | null;
@@ -33,7 +32,6 @@ interface BillingOperationParams {
 export declare function insertBillingOperationLog(supabase: SupabaseClient, ctx: BillingOperationContext, params: BillingOperationParams): Promise<string | null>;
 export declare function insertScreenshotOperationLog(supabase: SupabaseClient, ctx: Omit<BillingOperationContext, 'operationType'>, params: BillingOperationParams): Promise<string | null>;
 export declare function insertClipOperationLog(supabase: SupabaseClient, ctx: Omit<BillingOperationContext, 'operationType'>, params: BillingOperationParams): Promise<string | null>;
-export declare function insertInteractiveDemoOperationLog(supabase: SupabaseClient, ctx: Omit<BillingOperationContext, 'operationType'>, params: BillingOperationParams): Promise<string | null>;
 export declare function cancelScreenshotOperationLogsForCapture(supabase: SupabaseClient, captureId: string, reason: string): Promise<void>;
 export declare function reconcilePendingBillingOperationCosts(supabase: SupabaseClient, operationIds?: string[]): Promise<void>;
 export {};

package/dist/billing-operation-logging.js

@@ -131,7 +131,6 @@ export async function insertBillingOperationLog(supabase, ctx, params) {
         capture_id: ctx.captureId ?? null,
         video_id: ctx.videoId ?? null,
         clip_record_id: ctx.clipRecordId ?? null,
-        interactive_demo_state_id: ctx.interactiveDemoStateId ?? null,
         operation_type: ctx.operationType,
         operation_outcome: params.outcome,
         outcome_reason: params.outcomeReason ?? null,
@@ -178,9 +177,6 @@ export async function insertScreenshotOperationLog(supabase, ctx, params) {
 export async function insertClipOperationLog(supabase, ctx, params) {
     return insertBillingOperationLog(supabase, { ...ctx, operationType: 'clip' }, params);
 }
-export async function insertInteractiveDemoOperationLog(supabase, ctx, params) {
-    return insertBillingOperationLog(supabase, { ...ctx, operationType: 'interactive_demo' }, params);
-}
 export async function cancelScreenshotOperationLogsForCapture(supabase, captureId, reason) {
     try {
         const { error } = await supabase

package/dist/capture-strategy.d.ts

@@ -2,8 +2,8 @@
  * Capture Agent — Capture Strategy
  *
  * Abstraction over the supported media modes: screenshot and clip.
- * The opcode runner is identical for all three — only the capture
- * opcodes dispatch to different strategies.
+ * The opcode runner is identical for both — only the capture opcodes dispatch
+ * to different strategies.
  */
 import type { ArtifactSpec, ArtifactResult, RuntimeAdapter, MediaMode } from './execution-types.js';
 export interface CaptureStrategy {
@@ -27,10 +27,4 @@ export declare class ClipStrategy implements CaptureStrategy {
     capture(adapter: RuntimeAdapter, _spec: ArtifactSpec): Promise<ArtifactResult>;
     postProcess(artifact: ArtifactResult, spec: ArtifactSpec): Promise<ArtifactResult>;
 }
-export declare class DomStrategy implements CaptureStrategy {
-    readonly mediaMode: "dom";
-    prepare(_adapter: RuntimeAdapter, _spec: ArtifactSpec): Promise<void>;
-    capture(adapter: RuntimeAdapter, _spec: ArtifactSpec): Promise<ArtifactResult>;
-    postProcess(artifact: ArtifactResult, _spec: ArtifactSpec): Promise<ArtifactResult>;
-}
 export declare function createCaptureStrategy(mediaMode: MediaMode): CaptureStrategy;

package/dist/capture-strategy.js

@@ -2,8 +2,8 @@
  * Capture Agent — Capture Strategy
  *
  * Abstraction over the supported media modes: screenshot and clip.
- * The opcode runner is identical for all three — only the capture
- * opcodes dispatch to different strategies.
+ * The opcode runner is identical for both — only the capture opcodes dispatch
+ * to different strategies.
  */
 // ── Screenshot strategy ─────────────────────────────────────────────
 export class ScreenshotStrategy {
@@ -58,39 +58,11 @@ export class ClipStrategy {
         return artifact;
     }
 }
-// ── DOM strategy (Interactive Demos — AUT-121) ──────────────────────
-export class DomStrategy {
-    mediaMode = 'dom';
-    async prepare(_adapter, _spec) {
-        // Nothing to prepare — DOM serialization happens inline in the
-        // CAPTURE_DOM opcode handler in opcode-runner.ts.
-    }
-    async capture(adapter, _spec) {
-        if (!adapter.serializeDom) {
-            throw new Error('DOM capture requires an adapter that implements serializeDom()');
-        }
-        const result = await adapter.serializeDom();
-        return {
-            mediaMode: 'dom',
-            buffer: Buffer.from(result.html, 'utf8'),
-            mimeType: 'text/html; charset=utf-8',
-            domHtml: result.html,
-            domAssetUrls: result.assetUrls,
-            domHtmlBytes: result.html.length,
-            dimensions: result.viewport,
-        };
-    }
-    async postProcess(artifact, _spec) {
-        // Phase 3 will add asset extraction (CAS), PurgeCSS and Brotli here.
-        return artifact;
-    }
-}
 // ── Factory ─────────────────────────────────────────────────────────
 export function createCaptureStrategy(mediaMode) {
     switch (mediaMode) {
         case 'screenshot': return new ScreenshotStrategy();
         case 'clip': return new ClipStrategy();
-        case 'dom': return new DomStrategy();
     }
 }
 //# sourceMappingURL=capture-strategy.js.map

package/dist/cli-config.d.ts

@@ -7,6 +7,7 @@ declare const DEFAULT_API_BASE_URL = "https://autokap.app";
 declare const DEFAULT_WS_URL = "wss://autokap.app/ws";
 declare const LOCAL_API_BASE_URL = "http://localhost:3000";
 declare const LOCAL_WS_URL = "ws://localhost:3000/ws";
+declare const API_KEY_ENV_VAR = "AUTOKAP_API_KEY";
 declare const API_BASE_URL_ENV_VAR = "AUTOKAP_API_BASE_URL";
 declare const WS_URL_ENV_VAR = "AUTOKAP_WS_URL";
 declare const ALLOW_UNSAFE_SERVER_ORIGIN_ENV_VAR = "AUTOKAP_ALLOW_UNSAFE_SERVER_ORIGIN";
@@ -18,4 +19,4 @@ export declare function readConfig(): Promise<AutokapConfig | null>;
 export declare function writeConfig(config: AutokapConfig): Promise<void>;
 export declare function deleteConfig(): Promise<void>;
 export declare function requireConfig(): Promise<AutokapConfig>;
-export { DEFAULT_API_BASE_URL, DEFAULT_WS_URL, LOCAL_API_BASE_URL, LOCAL_WS_URL, API_BASE_URL_ENV_VAR, WS_URL_ENV_VAR, ALLOW_UNSAFE_SERVER_ORIGIN_ENV_VAR, };
+export { DEFAULT_API_BASE_URL, DEFAULT_WS_URL, LOCAL_API_BASE_URL, LOCAL_WS_URL, API_KEY_ENV_VAR, API_BASE_URL_ENV_VAR, WS_URL_ENV_VAR, ALLOW_UNSAFE_SERVER_ORIGIN_ENV_VAR, };

package/dist/cli-config.js

@@ -6,6 +6,7 @@ const DEFAULT_API_BASE_URL = 'https://autokap.app';
 const DEFAULT_WS_URL = 'wss://autokap.app/ws';
 const LOCAL_API_BASE_URL = 'http://localhost:3000';
 const LOCAL_WS_URL = 'ws://localhost:3000/ws';
+const API_KEY_ENV_VAR = 'AUTOKAP_API_KEY';
 const API_BASE_URL_ENV_VAR = 'AUTOKAP_API_BASE_URL';
 const WS_URL_ENV_VAR = 'AUTOKAP_WS_URL';
 const ALLOW_UNSAFE_SERVER_ORIGIN_ENV_VAR = 'AUTOKAP_ALLOW_UNSAFE_SERVER_ORIGIN';
@@ -22,6 +23,17 @@ export function getDefaultWsUrl(apiBaseUrl = getDefaultApiBaseUrl()) {
     return normalizeUrl(process.env[WS_URL_ENV_VAR]) ?? deriveWsUrl(apiBaseUrl);
 }
 export async function readConfig() {
+    const envApiKey = normalizeApiKey(process.env[API_KEY_ENV_VAR]);
+    if (envApiKey) {
+        const apiBaseUrl = getDefaultApiBaseUrl();
+        const wsUrl = getDefaultWsUrl(apiBaseUrl);
+        assertAllowedApiOrigin(apiBaseUrl, DEFAULT_API_BASE_URL, API_BASE_URL_ENV_VAR);
+        return {
+            apiKey: envApiKey,
+            apiBaseUrl,
+            wsUrl,
+        };
+    }
     try {
         const raw = await fs.readFile(getConfigPath(), 'utf-8');
         const parsed = JSON.parse(raw);
@@ -81,11 +93,15 @@ export async function requireConfig() {
         process.exit(1);
     }
     if (!config) {
-        logger.error('Not authenticated. Run `npx autokap@latest init --cli-key <key>` first.');
+        logger.error(`Not authenticated. Run \`npx autokap@latest init --cli-key <key>\` first, or set ${API_KEY_ENV_VAR} in CI.`);
         process.exit(1);
     }
     return config;
 }
+function normalizeApiKey(value) {
+    const trimmed = value?.trim();
+    return trimmed || null;
+}
 function normalizeUrl(value) {
     const trimmed = value?.trim();
     if (!trimmed)
@@ -143,5 +159,5 @@ function assertAllowedApiOrigin(candidateUrl, baselineUrl, envVar) {
     }
     throw new Error(`Refusing unsafe server override to ${candidateOrigin}. Set ${ALLOW_UNSAFE_SERVER_ORIGIN_ENV_VAR}=1 to allow ${envVar ?? 'this override'} explicitly.`);
 }
-export { DEFAULT_API_BASE_URL, DEFAULT_WS_URL, LOCAL_API_BASE_URL, LOCAL_WS_URL, API_BASE_URL_ENV_VAR, WS_URL_ENV_VAR, ALLOW_UNSAFE_SERVER_ORIGIN_ENV_VAR, };
+export { DEFAULT_API_BASE_URL, DEFAULT_WS_URL, LOCAL_API_BASE_URL, LOCAL_WS_URL, API_KEY_ENV_VAR, API_BASE_URL_ENV_VAR, WS_URL_ENV_VAR, ALLOW_UNSAFE_SERVER_ORIGIN_ENV_VAR, };
 //# sourceMappingURL=cli-config.js.map

package/dist/cli-contract.d.ts

@@ -14,6 +14,7 @@ export declare const CLI_ADVANCED_SKILL_COMMAND = "autokap skill --agent <agent>
 export declare const CLI_FALLBACK_PROGRAM_COMMAND = "autokap run <preset-id> --program <file>";
 export declare function buildCliRunCommand(presetId: string, options?: {
     local?: boolean;
+    env?: string;
 }): string;
 export declare function buildCliInstalledSetupCommand(cliKey: string): string;
 export declare const CLI_PUBLIC_COMMANDS: CliPublicCommandDescriptor[];

package/dist/cli-contract.js

@@ -7,7 +7,7 @@ export const CLI_DEFAULT_SETUP_COMMAND = "npx autokap@latest init --cli-key <you
 export const CLI_ADVANCED_SKILL_COMMAND = "autokap skill --agent <agent>";
 export const CLI_FALLBACK_PROGRAM_COMMAND = "autokap run <preset-id> --program <file>";
 export function buildCliRunCommand(presetId, options = {}) {
-    return `autokap run${options.local ? " --local" : ""} ${presetId}`;
+    return `autokap run${options.local ? " --local" : ""}${options.env ? ` --env ${options.env}` : ""} ${presetId}`;
 }
 export function buildCliInstalledSetupCommand(cliKey) {
     return `autokap init --cli-key ${cliKey}`;
@@ -45,10 +45,16 @@ export const CLI_PUBLIC_COMMANDS = [
     },
     {
         id: "run",
-        command: "autokap run <preset-id>",
+        command: "autokap run <preset-id> --env local",
         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 CI auto-recapture in a project",
+        docsDescriptionKey: "cliCmdAutoRecapture",
+    },
     {
         id: "run-headed",
         command: "autokap run <preset-id> --headed",

package/dist/cli-runner-local.d.ts

@@ -9,4 +9,6 @@ export declare function runLocal(presetId: string, opts: {
     output?: string;
     program?: string;
     debug?: boolean;
+    env?: string;
+    allowUploadFailure?: boolean;
 }): Promise<void>;

package/dist/cli-runner-local.js

@@ -24,7 +24,9 @@ export async function runLocal(presetId, opts) {
     }
     const run = await runCapture({
         presetId,
+        env: opts.env,
         program,
+        allowUploadFailure: opts.allowUploadFailure,
         headed: opts.headed,
         onProgress: (event) => {
             const prefix = `[capture][${event.variantId}]`;
@@ -73,27 +75,16 @@ async function persistArtifactsLocally(presetId, outputDirOption, variants) {
     for (const variant of variants) {
         for (let index = 0; index < variant.artifacts.length; index += 1) {
             const artifact = variant.artifacts[index];
-            const ext = artifact.mediaMode === 'dom'
-                ? 'html'
-                : artifact.mimeType === 'image/png'
-                    ? 'png'
-                    : artifact.mimeType === 'image/jpeg'
-                        ? 'jpg'
-                        : artifact.mimeType.includes('gif')
-                            ? 'gif'
-                            : artifact.mimeType.includes('mp4')
-                                ? 'mp4'
-                                : 'webm';
-            let suffix = '';
-            if (artifact.mediaMode === 'dom') {
-                if (artifact.fragmentName && artifact.parentStateName) {
-                    suffix = `-${sanitizePathToken(artifact.parentStateName)}-fragment-${sanitizePathToken(artifact.fragmentName)}`;
-                }
-                else if (artifact.stateName) {
-                    suffix = `-${sanitizePathToken(artifact.stateName)}`;
-                }
-            }
-            const fileName = `capture-${sanitizePathToken(presetId.slice(0, 8))}-${sanitizePathToken(variant.variantId)}${suffix}-${index}.${ext}`;
+            const ext = artifact.mimeType === 'image/png'
+                ? 'png'
+                : artifact.mimeType === 'image/jpeg'
+                    ? 'jpg'
+                    : artifact.mimeType.includes('gif')
+                        ? 'gif'
+                        : artifact.mimeType.includes('mp4')
+                            ? 'mp4'
+                            : 'webm';
+            const fileName = `capture-${sanitizePathToken(presetId.slice(0, 8))}-${sanitizePathToken(variant.variantId)}-${index}.${ext}`;
             const filePath = resolveContainedPath(outputDir, fileName);
             await fs.writeFile(filePath, artifact.buffer);
             logger.info(`[capture] Artifact saved locally: ${filePath}`);

package/dist/cli-runner.d.ts

@@ -15,8 +15,12 @@ import type { ExecutionProgram, RunResult } from './execution-types.js';
 export interface CLIRunnerOptions {
     /** Preset ID to run */
     presetId: string;
+    /** Project environment name used by the server to resolve capture URLs */
+    env?: string;
     /** Override: provide program directly instead of fetching from server */
     program?: ExecutionProgram;
+    /** Keep the legacy success result when upload/telemetry persistence fails */
+    allowUploadFailure?: boolean;
     /** Selector memory map (fetched from server or cached locally) */
     selectorMemory?: Record<string, string[]>;
     /** Show browser window. Default: false (headless) */

package/dist/cli-runner.js

@@ -46,7 +46,7 @@ export async function runCapture(options) {
         };
     }
     else {
-        const fetched = await fetchProgram(config, options.presetId);
+        const fetched = await fetchProgram(config, options.presetId, options.env);
         if (!fetched.success) {
             return { success: false, error: fetched.error };
         }
@@ -151,15 +151,29 @@ export async function runCapture(options) {
         logger.info(`[capture] Captures saved successfully — total ${totalDurationSec}s`);
     }
     catch (err) {
-        logger.error(`[capture] Failed to upload results: ${err instanceof Error ? err.message : String(err)}`);
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error(`[capture] Failed to upload results: ${message}`);
+        if (!options.allowUploadFailure) {
+            return {
+                success: false,
+                runResult,
+                error: runResult.success
+                    ? `upload failed: ${message}`
+                    : `${runResult.error ?? 'capture failed'}; upload failed: ${message}`,
+            };
+        }
+        logger.warn('[capture] Continuing after upload failure because --allow-upload-failure was set');
     }
     return { success: runResult.success, runResult };
 }
 // ── Server communication ────────────────────────────────────────────
-async function fetchProgram(config, presetId) {
+async function fetchProgram(config, presetId, environmentName) {
     try {
-        const url = `${config.apiBaseUrl}/api/cli/programs/${presetId}`;
-        const response = await fetch(url, {
+        const url = new URL(`${config.apiBaseUrl}/api/cli/programs/${presetId}`);
+        if (environmentName) {
+            url.searchParams.set('env', environmentName);
+        }
+        const response = await fetch(url.toString(), {
             headers: {
                 'Authorization': `Bearer ${config.apiKey}`,
                 'Content-Type': 'application/json',
@@ -167,7 +181,7 @@ async function fetchProgram(config, presetId) {
             },
         });
         if (!response.ok) {
-            return { success: false, error: await formatServerError(response, url) };
+            return { success: false, error: await formatServerError(response, url.toString()) };
         }
         const data = await response.json();
         const envelope = verifySignedExecutionProgramEnvelope({
@@ -195,7 +209,7 @@ async function uploadResults(config, program, result) {
             const formData = new FormData();
             const filename = buildArtifactFilename(program.presetId, variant.variantId, artifact);
             uploadedCount += 1;
-            const label = artifact.captureName ?? artifact.clipName ?? artifact.fragmentName ?? artifact.stateName ?? filename;
+            const label = artifact.captureName ?? artifact.clipName ?? filename;
             logger.info(`[capture] Exporting capture ${uploadedCount}/${totalArtifacts}: ${label}`);
             formData.append('file', new Blob([new Uint8Array(artifact.buffer)], { type: artifact.mimeType }), filename);
             formData.append('presetId', program.presetId);
@@ -253,35 +267,6 @@ async function uploadResults(config, program, result) {
             if (typeof artifact.trimStartMs === 'number') {
                 formData.append('trimStartMs', String(artifact.trimStartMs));
             }
-            // ── Interactive demo (mediaMode === 'dom') ──
-            if (artifact.stateName) {
-                formData.append('stateName', artifact.stateName);
-            }
-            if (artifact.domAssetUrls && artifact.domAssetUrls.length > 0) {
-                formData.append('domAssetUrls', JSON.stringify(artifact.domAssetUrls));
-            }
-            if (artifact.domThumbnailBuffer) {
-                formData.append('domThumbnail', new Blob([new Uint8Array(artifact.domThumbnailBuffer)], { type: 'image/png' }), 'thumbnail.png');
-            }
-            // Phase 5: fragment fields
-            if (artifact.fragmentName) {
-                formData.append('fragmentName', artifact.fragmentName);
-            }
-            // Phase 8: variant of the fragment capture (defaults to 'default'
-            // server-side when omitted, but we always send it explicitly so the
-            // upload row's unique key includes it).
-            if (artifact.fragmentVariantName) {
-                formData.append('fragmentVariantName', artifact.fragmentVariantName);
-            }
-            if (artifact.parentStateName) {
-                formData.append('parentStateName', artifact.parentStateName);
-            }
-            if (artifact.mountStrategy) {
-                formData.append('mountStrategy', artifact.mountStrategy);
-            }
-            if (artifact.mountTargetSelector) {
-                formData.append('mountTargetSelector', artifact.mountTargetSelector);
-            }
             const response = await fetch(`${config.apiBaseUrl}/api/cli/artifacts`, {
                 method: 'POST',
                 headers: { 'Authorization': `Bearer ${config.apiKey}` },
@@ -438,17 +423,15 @@ function createHealerLLMProvider(llmConfig) {
     };
 }
 function buildArtifactFilename(presetId, variantId, artifact) {
-    const ext = artifact.mediaMode === 'dom'
-        ? 'html'
-        : artifact.mimeType === 'image/jpeg'
-            ? 'jpg'
-            : artifact.mimeType === 'image/png'
-                ? 'png'
-                : artifact.mimeType.includes('gif')
-                    ? 'gif'
-                    : artifact.mimeType.includes('mp4')
-                        ? 'mp4'
-                        : 'webm';
+    const ext = artifact.mimeType === 'image/jpeg'
+        ? 'jpg'
+        : artifact.mimeType === 'image/png'
+            ? 'png'
+            : artifact.mimeType.includes('gif')
+                ? 'gif'
+                : artifact.mimeType.includes('mp4')
+                    ? 'mp4'
+                    : 'webm';
     const stepToken = typeof artifact.stepIndex === 'number' ? `-${artifact.stepIndex}` : '';
     return `${sanitizeArtifactToken(presetId)}-${sanitizeArtifactToken(variantId)}${stepToken}.${ext}`;
 }
@@ -497,9 +480,6 @@ function sanitizeArtifactForTelemetry(artifact) {
         altText: redactTelemetryText(artifact.altText),
         captureUrl: redactUrl(artifact.captureUrl),
         elementSelector: undefined,
-        domAssetUrls: artifact.domAssetUrls
-            ?.map((entry) => redactUrl(entry))
-            .filter((entry) => Boolean(entry)),
     };
 }
 function sanitizeHealerPatches(patches) {