videoclaw 3.0.0-alpha.1

package/dist/video/native-flow-r2v.d.ts

@@ -0,0 +1,113 @@
+/**
+ * native-flow-r2v.ts — first-class Google Flow Reference-to-Video (R2V) scene
+ * render via saved **Flow Characters**, the proven character-ad workflow.
+ *
+ * Unlike the produce/execute path (which routes through the bun `vclaw-cli`
+ * flow.ts and a full readiness/storyboard ceremony), this is a lightweight,
+ * pure-Node fetch transport — the same shape as {@link ./native-runway} /
+ * {@link ./native-dreamina} — for rendering ONE scene directly from character
+ * references:
+ *
+ *   POST {BASE}/google-flow/videos   { email, prompt, model, aspectRatio,
+ *     duration, async, character_1..7 }            → { jobid }
+ *   GET  {BASE}/google-flow/jobs/{jobid}  (jobid VERBATIM — encoding → 400)
+ *     → { status: started|completed|failed, ... videoUrl }
+ *
+ * R2V constraints (vclaw-cli/src/backends/types.ts, live-proven 2026-06-11):
+ *   - model MUST be `veo-3.1-fast` (veo-3.1-quality rejects character_*).
+ *   - character refs only (character_1..7) — NO startImage (can't mix R2V + I2V).
+ *   - Veo generates the character's voice + lip-sync NATIVELY from the prompt.
+ *   - Flow burst-throttles with a 403 reCAPTCHA (PUBLIC_ERROR_UNUSUAL_ACTIVITY);
+ *     this transport cools down and retries the SUBMIT for that case only.
+ *
+ * Transports (fetch + sleep) are injectable so the whole module is unit-testable
+ * offline with no network and no real waiting.
+ */
+export declare const FLOW_BASE = "https://api.useapi.net/v1";
+export declare const FLOW_R2V_MODEL = "veo-3.1-fast";
+export declare const FLOW_R2V_DURATIONS: Set<number>;
+export interface FlowFetchResponse {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    /** Optional so test fakes can omit it; real fetch always provides it. */
+    headers?: {
+        get(name: string): string | null;
+    };
+}
+/**
+ * Server-stated throttle cooldown in ms, or null. Prefers the `Retry-After`
+ * header (seconds or an HTTP/ISO date), then the response body's `retryAfter`
+ * field (legacy seconds, or — current useapi shape since 2026-06-15 — an ISO
+ * timestamp string). Honoring this waits the REAL window the load balancer
+ * reports instead of a fixed guess.
+ */
+export declare function flowRetryAfterMs(res: {
+    headers?: {
+        get(name: string): string | null;
+    };
+}, parsedBody: Record<string, unknown>): number | null;
+export type FlowFetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}) => Promise<FlowFetchResponse>;
+export interface FlowR2vOptions {
+    /** Scene prompt (dialogue goes inline; prompt hygiene is applied by the caller). */
+    prompt: string;
+    /** Resolved character refs → character_1..7 (1–7; the person + optional product). */
+    characterRefs: string[];
+    outputPath: string;
+    /** 4 | 6 | 8 | 10 seconds (default 8). */
+    durationSeconds?: number;
+    /** 'landscape' | 'portrait' (default 'landscape'). */
+    aspectRatio?: 'landscape' | 'portrait';
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: FlowFetchLike;
+    sleepImpl?: (ms: number) => Promise<void>;
+    /** Cooldown-retries for a 403 reCAPTCHA / 429 throttle on SUBMIT (default 2). */
+    maxRecaptchaRetries?: number;
+    /** Cooldown between throttle retries, ms, when the server states no window (default 5 min). */
+    recaptchaCooldownMs?: number;
+    /**
+     * Max in-process wait for a server-stated Retry-After window (default 10 min).
+     * A longer quarantine (e.g. the ~30-min USER_QUOTA window) fails fast with the
+     * real wait instead of blocking the process for it.
+     */
+    maxThrottleWaitMs?: number;
+    pollIntervalMs?: number;
+    maxPolls?: number;
+}
+export interface FlowR2vResult {
+    jobId: string;
+    outputPath: string;
+    videoUrl: string;
+    characterCount: number;
+    model: string;
+    durationSeconds: number;
+    aspectRatio: string;
+}
+/**
+ * Render one R2V scene from saved Flow character refs and download it to
+ * `outputPath`. Throws a clear error on a non-throttle failure; cools down and
+ * retries the submit on a 403 reCAPTCHA throttle.
+ */
+export declare function submitFlowR2vNative(options: FlowR2vOptions & {
+    workspaceRoot?: string;
+}): Promise<FlowR2vResult>;
+export interface R2vPromptHygieneOptions {
+    /** Keep Veo's generated music in the clip (default false → suppress it). */
+    keepMusic?: boolean;
+    /** Allow room reverb on the voice (default false → dry close-mic). */
+    allowReverb?: boolean;
+}
+/**
+ * Append the standing character-ad audio directives to a scene prompt, unless
+ * opted out. Suppressing Veo-generated music keeps the clip audio voice-only so
+ * a post bed can sit under it without clashing; the dry close-mic directive
+ * fixes Veo's default echoey delivery. Idempotent-ish (only appends when not
+ * already present). Pure.
+ */
+export declare function applyR2vPromptHygiene(prompt: string, options?: R2vPromptHygieneOptions): string;
+//# sourceMappingURL=native-flow-r2v.d.ts.map

package/dist/video/native-flow-r2v.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-flow-r2v.d.ts","sourceRoot":"","sources":["../../src/video/native-flow-r2v.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAMH,eAAO,MAAM,SAAS,8BAA8B,CAAC;AACrD,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C,eAAO,MAAM,kBAAkB,aAAyB,CAAC;AAGzD,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;IACpC,yEAAyE;IACzE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAChD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE;IAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,EACvD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,GAAG,IAAI,CAef;AACD,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,KACxE,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAEhC,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;IACf,qFAAqF;IACrF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAqBD;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,cAAc,GAAG;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,aAAa,CAAC,CAoGxB;AAiBD,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,uBAA4B,GAAG,MAAM,CASnG"}

package/dist/video/native-flow-r2v.js

@@ -0,0 +1,223 @@
+/**
+ * native-flow-r2v.ts — first-class Google Flow Reference-to-Video (R2V) scene
+ * render via saved **Flow Characters**, the proven character-ad workflow.
+ *
+ * Unlike the produce/execute path (which routes through the bun `vclaw-cli`
+ * flow.ts and a full readiness/storyboard ceremony), this is a lightweight,
+ * pure-Node fetch transport — the same shape as {@link ./native-runway} /
+ * {@link ./native-dreamina} — for rendering ONE scene directly from character
+ * references:
+ *
+ *   POST {BASE}/google-flow/videos   { email, prompt, model, aspectRatio,
+ *     duration, async, character_1..7 }            → { jobid }
+ *   GET  {BASE}/google-flow/jobs/{jobid}  (jobid VERBATIM — encoding → 400)
+ *     → { status: started|completed|failed, ... videoUrl }
+ *
+ * R2V constraints (vclaw-cli/src/backends/types.ts, live-proven 2026-06-11):
+ *   - model MUST be `veo-3.1-fast` (veo-3.1-quality rejects character_*).
+ *   - character refs only (character_1..7) — NO startImage (can't mix R2V + I2V).
+ *   - Veo generates the character's voice + lip-sync NATIVELY from the prompt.
+ *   - Flow burst-throttles with a 403 reCAPTCHA (PUBLIC_ERROR_UNUSUAL_ACTIVITY);
+ *     this transport cools down and retries the SUBMIT for that case only.
+ *
+ * Transports (fetch + sleep) are injectable so the whole module is unit-testable
+ * offline with no network and no real waiting.
+ */
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+export const FLOW_BASE = 'https://api.useapi.net/v1';
+export const FLOW_R2V_MODEL = 'veo-3.1-fast';
+export const FLOW_R2V_DURATIONS = new Set([4, 6, 8, 10]);
+const RECAPTCHA_RE = /recaptcha|unusual_activity|permission_denied/i;
+/**
+ * Server-stated throttle cooldown in ms, or null. Prefers the `Retry-After`
+ * header (seconds or an HTTP/ISO date), then the response body's `retryAfter`
+ * field (legacy seconds, or — current useapi shape since 2026-06-15 — an ISO
+ * timestamp string). Honoring this waits the REAL window the load balancer
+ * reports instead of a fixed guess.
+ */
+export function flowRetryAfterMs(res, parsedBody) {
+    const header = res.headers?.get?.('retry-after');
+    if (header) {
+        const secs = Number(header);
+        if (Number.isFinite(secs) && secs >= 0)
+            return secs * 1000;
+        const ms = Date.parse(header);
+        if (!Number.isNaN(ms)) {
+            const d = ms - Date.now();
+            if (d > 0)
+                return d;
+        }
+    }
+    const field = parsedBody.retryAfter;
+    if (typeof field === 'number' && Number.isFinite(field) && field >= 0)
+        return field * 1000;
+    if (typeof field === 'string') {
+        const ms = Date.parse(field);
+        if (!Number.isNaN(ms)) {
+            const d = ms - Date.now();
+            if (d > 0)
+                return d;
+        }
+    }
+    return null;
+}
+function readDotEnvLike(raw) {
+    const out = {};
+    for (const line of raw.split('\n')) {
+        const m = line.match(/^\s*([A-Z0-9_]+)\s*=\s*(.*)\s*$/);
+        if (m)
+            out[m[1]] = m[2].replace(/^['"]|['"]$/g, '').trim();
+    }
+    return out;
+}
+async function resolveEnv(env, workspaceRoot) {
+    if (workspaceRoot) {
+        const envLocal = join(workspaceRoot, '.env.local');
+        if (existsSync(envLocal))
+            return { ...readDotEnvLike(await readFile(envLocal, 'utf-8')), ...env };
+    }
+    return env;
+}
+const defaultSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+ * Render one R2V scene from saved Flow character refs and download it to
+ * `outputPath`. Throws a clear error on a non-throttle failure; cools down and
+ * retries the submit on a 403 reCAPTCHA throttle.
+ */
+export async function submitFlowR2vNative(options) {
+    const refs = options.characterRefs.filter((r) => r && r.trim()).slice(0, 7);
+    if (refs.length === 0) {
+        throw new Error('flow-r2v requires at least one character reference (the person and/or product).');
+    }
+    const duration = options.durationSeconds ?? 8;
+    if (!FLOW_R2V_DURATIONS.has(duration)) {
+        throw new Error(`flow-r2v duration must be one of ${[...FLOW_R2V_DURATIONS].join(', ')} (got ${duration}).`);
+    }
+    const aspectRatio = options.aspectRatio ?? 'landscape';
+    const env = await resolveEnv(options.env ?? process.env, options.workspaceRoot);
+    const token = env.USEAPI_API_TOKEN?.trim();
+    const email = env.USEAPI_ACCOUNT_EMAIL?.trim();
+    if (!token)
+        throw new Error('flow-r2v requires USEAPI_API_TOKEN in the environment.');
+    if (!email)
+        throw new Error('flow-r2v requires USEAPI_ACCOUNT_EMAIL in the environment.');
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const sleep = options.sleepImpl ?? defaultSleep;
+    const headers = { Authorization: `Bearer ${token}`, 'Content-Type': 'application/json' };
+    const body = {
+        email,
+        prompt: options.prompt,
+        model: FLOW_R2V_MODEL,
+        aspectRatio,
+        duration,
+        async: true,
+    };
+    refs.forEach((ref, i) => { body[`character_${i + 1}`] = ref; });
+    // --- submit (with bounded throttle cooldown-retry) ---
+    const maxRetries = options.maxRecaptchaRetries ?? 2;
+    const cooldownMs = options.recaptchaCooldownMs ?? 5 * 60 * 1000;
+    const maxThrottleWaitMs = options.maxThrottleWaitMs ?? 10 * 60 * 1000;
+    let jobId = '';
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        const res = await fetchImpl(`${FLOW_BASE}/google-flow/videos`, { method: 'POST', headers, body: JSON.stringify(body) });
+        const text = await res.text();
+        if (res.ok) {
+            const parsed = safeJson(text);
+            jobId = String(parsed.jobid ?? parsed.jobId ?? parsed.job?.jobid ?? parsed.id ?? '');
+            if (!jobId)
+                throw new Error(`flow-r2v submit returned no jobId: ${text.slice(0, 200)}`);
+            break;
+        }
+        // Throttle (403 reCAPTCHA burst, or 429 quota/traffic) → cool down + retry
+        // the submit (NOT a content reject). Honor the server-stated Retry-After
+        // window when present; otherwise use the fixed cooldown.
+        const isThrottle = res.status === 429 || (res.status === 403 && RECAPTCHA_RE.test(text));
+        if (isThrottle && attempt < maxRetries) {
+            const serverMs = flowRetryAfterMs(res, safeJson(text));
+            if (serverMs !== null && serverMs > maxThrottleWaitMs) {
+                throw new Error(`flow-r2v submit throttled (HTTP ${res.status}): server quarantine window is ~${Math.round(serverMs / 60_000)} min — ` +
+                    `retry after that, or add accounts / wait for the quota to clear.`);
+            }
+            await sleep(serverMs ?? cooldownMs);
+            continue;
+        }
+        throw new Error(`flow-r2v submit failed (HTTP ${res.status}): ${text.slice(0, 300)}`);
+    }
+    // --- poll (jobId VERBATIM) ---
+    const interval = options.pollIntervalMs ?? 12000;
+    const maxPolls = options.maxPolls ?? 90;
+    let videoUrl = '';
+    for (let i = 0; i < maxPolls; i++) {
+        const res = await fetchImpl(`${FLOW_BASE}/google-flow/jobs/${jobId}`, { method: 'GET', headers });
+        const text = await res.text();
+        const parsed = safeJson(text);
+        const status = String(parsed.status ?? '').toLowerCase();
+        if (status === 'completed') {
+            videoUrl = extractVideoUrl(parsed, text);
+            if (!videoUrl)
+                throw new Error(`flow-r2v completed but no videoUrl: ${text.slice(0, 200)}`);
+            break;
+        }
+        if (status === 'failed') {
+            const detail = String(parsed.error ?? '') + ' ' + JSON.stringify(parsed.errorDetails ?? parsed.raw ?? '').slice(0, 200);
+            throw new Error(`flow-r2v generation failed: ${detail.trim()}`);
+        }
+        if (i < maxPolls - 1)
+            await sleep(interval);
+    }
+    if (!videoUrl)
+        throw new Error('flow-r2v poll timed out before completion.');
+    // --- download ---
+    const dl = await fetchImpl(videoUrl, { method: 'GET' });
+    if (!dl.ok)
+        throw new Error(`flow-r2v download failed (HTTP ${dl.status}).`);
+    const bytes = Buffer.from(await dl.arrayBuffer());
+    await mkdir(dirname(options.outputPath), { recursive: true });
+    await writeFile(options.outputPath, bytes);
+    return {
+        jobId,
+        outputPath: options.outputPath,
+        videoUrl,
+        characterCount: refs.length,
+        model: FLOW_R2V_MODEL,
+        durationSeconds: duration,
+        aspectRatio,
+    };
+}
+function safeJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return {};
+    }
+}
+function extractVideoUrl(parsed, rawText) {
+    const response = parsed.response;
+    const media = (response?.media ?? parsed.media);
+    const fromMedia = media?.[0]?.videoUrl;
+    if (typeof fromMedia === 'string' && fromMedia)
+        return fromMedia;
+    const scan = rawText.match(/https:\/\/[^"]+\.mp4[^"]*/);
+    return scan ? scan[0] : '';
+}
+/**
+ * Append the standing character-ad audio directives to a scene prompt, unless
+ * opted out. Suppressing Veo-generated music keeps the clip audio voice-only so
+ * a post bed can sit under it without clashing; the dry close-mic directive
+ * fixes Veo's default echoey delivery. Idempotent-ish (only appends when not
+ * already present). Pure.
+ */
+export function applyR2vPromptHygiene(prompt, options = {}) {
+    const clauses = [];
+    if (!options.allowReverb && !/no echo|no reverb|close-mic|close-microphone/i.test(prompt)) {
+        clauses.push('Any spoken voice is clean, dry and intimate, recorded close-microphone with no echo and no reverb.');
+    }
+    if (!options.keepMusic && !/no music|no instrumental|no soundtrack/i.test(prompt)) {
+        clauses.push('No music, no instrumental, no background soundtrack in the audio — only the spoken voice and subtle natural room ambience.');
+    }
+    return clauses.length > 0 ? `${prompt.trim()} ${clauses.join(' ')}` : prompt;
+}
+//# sourceMappingURL=native-flow-r2v.js.map

package/dist/video/native-flow-r2v.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-flow-r2v.js","sourceRoot":"","sources":["../../src/video/native-flow-r2v.ts"],"names":[],"mappings":"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"}

package/dist/video/native-runway.d.ts

@@ -0,0 +1,41 @@
+import type { VideoExecutionCancelResult, VideoExecutionPayload, VideoExecutionPollResult } from './types.js';
+interface FetchLikeResponse {
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+    arrayBuffer(): Promise<ArrayBuffer>;
+}
+type FetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string | Uint8Array;
+}) => Promise<FetchLikeResponse>;
+export declare function submitRunwayUseApiNative(payload: VideoExecutionPayload, options?: {
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: FetchLike;
+    /**
+     * Stable job id to resume into. When provided, existing per-scene state at
+     * `.vclaw-jobs/<externalJobId>.json` is loaded and already-submitted scenes
+     * are skipped (never re-submitted). Omit for a fresh submission.
+     */
+    externalJobId?: string;
+}): Promise<{
+    externalJobId: string;
+    rawResult: unknown;
+}>;
+export declare function pollRunwayUseApiNative(input: {
+    outputDir: string;
+    externalJobId: string;
+    workspaceRoot: string;
+}, options?: {
+    env?: NodeJS.ProcessEnv;
+    fetchImpl?: FetchLike;
+}): Promise<VideoExecutionPollResult>;
+export declare function cancelRunwayUseApiNative(input: {
+    outputDir: string;
+    externalJobId: string;
+    workspaceRoot: string;
+}): Promise<VideoExecutionCancelResult>;
+export {};
+//# sourceMappingURL=native-runway.d.ts.map

package/dist/video/native-runway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-runway.d.ts","sourceRoot":"","sources":["../../src/video/native-runway.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAmB9G,UAAU,iBAAiB;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;CACrC;AAED,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CAC5B,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;AAgPjC,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,qBAAqB,EAC9B,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACnB,GACL,OAAO,CAAC;IACT,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC,CA0OD;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,EACD,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,SAAS,CAAC,EAAE,SAAS,CAAC;CAClB,GACL,OAAO,CAAC,wBAAwB,CAAC,CAqEnC;AAED,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,0BAA0B,CAAC,CAqBrC"}