@amaster.ai/pi-video-gen 0.1.2-beta.48

package/dist/providers/ark.d.ts

@@ -0,0 +1,26 @@
+import type { VideoProviderAdapter } from '../types.js';
+import { requestFingerprint } from './request.js';
+/**
+ * Volcengine Ark video generation (ByteDance Seedance series).
+ *
+ *   POST {baseUrl}/contents/generations/tasks         → { id }
+ *   GET  {baseUrl}/contents/generations/tasks/{id}    → { status, content.video_url }
+ *
+ * Seedance 2.0 takes structured params (resolution/ratio/duration/
+ * generate_audio/watermark) alongside the content array.
+ * Reference images ride in the content array with a `role` of
+ * `first_frame` / `last_frame` / `reference_image`.
+ *
+ * Docs: https://www.volcengine.com/docs/82379/1520757
+ *
+ * Idempotency note (per design review): Ark's task-creation idempotency
+ * support (client token / idempotency key / task-list lookup) is UNVERIFIED
+ * until the M0 probe reports. So submit() never silently retries: 4xx fails
+ * fast (the request won't become valid), and network/5xx failures raise an
+ * AMBIGUOUS error that tells the user to check the console for a possibly
+ * created paid task before retrying.
+ */
+export declare const ARK_DEFAULT_BASE_URL = "https://ark.cn-beijing.volces.com/api/v3";
+export { requestFingerprint as fingerprint };
+export declare const arkAdapter: VideoProviderAdapter;
+//# sourceMappingURL=ark.d.ts.map

package/dist/providers/ark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ark.d.ts","sourceRoot":"","sources":["../../src/providers/ark.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAIV,oBAAoB,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,eAAO,MAAM,oBAAoB,6CAA6C,CAAC;AAiC/E,OAAO,EAAE,kBAAkB,IAAI,WAAW,EAAE,CAAC;AAU7C,eAAO,MAAM,UAAU,EAAE,oBAkJxB,CAAC"}

package/dist/providers/ark.js

@@ -0,0 +1,178 @@
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { AmbiguousSubmitError, httpStatusError, missingKeyError, networkError, redactUrl, safeBasename, VideoGenError, } from '../errors.js';
+import { requestFingerprint } from './request.js';
+import { downloadFile } from './task.js';
+/**
+ * Volcengine Ark video generation (ByteDance Seedance series).
+ *
+ *   POST {baseUrl}/contents/generations/tasks         → { id }
+ *   GET  {baseUrl}/contents/generations/tasks/{id}    → { status, content.video_url }
+ *
+ * Seedance 2.0 takes structured params (resolution/ratio/duration/
+ * generate_audio/watermark) alongside the content array.
+ * Reference images ride in the content array with a `role` of
+ * `first_frame` / `last_frame` / `reference_image`.
+ *
+ * Docs: https://www.volcengine.com/docs/82379/1520757
+ *
+ * Idempotency note (per design review): Ark's task-creation idempotency
+ * support (client token / idempotency key / task-list lookup) is UNVERIFIED
+ * until the M0 probe reports. So submit() never silently retries: 4xx fails
+ * fast (the request won't become valid), and network/5xx failures raise an
+ * AMBIGUOUS error that tells the user to check the console for a possibly
+ * created paid task before retrying.
+ */
+export const ARK_DEFAULT_BASE_URL = 'https://ark.cn-beijing.volces.com/api/v3';
+const MIME_BY_EXT = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+};
+async function imageFileToDataUri(path) {
+    const mime = MIME_BY_EXT[extname(path).toLowerCase()];
+    if (!mime) {
+        throw new VideoGenError(`Reference image must be png/jpg/webp: ${safeBasename(path)}`, 'ark: unsupported image extension');
+    }
+    let bytes;
+    try {
+        bytes = await readFile(path);
+    }
+    catch {
+        throw new VideoGenError(`Reference image is not readable: ${safeBasename(path)}`, 'ark: image unreadable');
+    }
+    return `data:${mime};base64,${bytes.toString('base64')}`;
+}
+function bearerHeaders(apiKey) {
+    return { authorization: `Bearer ${apiKey}`, 'content-type': 'application/json' };
+}
+export { requestFingerprint as fingerprint };
+/** Thrown when submit failed without a definitive server verdict (network/5xx). */
+function ambiguousSubmitError() {
+    return new AmbiguousSubmitError('Task creation failed with an ambiguous result (network error or server 5xx). The provider MAY have created a paid task — check the Volcengine Ark console before retrying to avoid double billing.', 'ark submit: ambiguous outcome');
+}
+export const arkAdapter = {
+    async submit(provider, remoteModelId, params, fetchImpl, signal) {
+        if (!provider.apiKey)
+            throw missingKeyError('ark', 'ARK_API_KEY', provider.apiKeyPath);
+        const content = [{ type: 'text', text: params.prompt }];
+        if (params.firstFramePath) {
+            content.push({
+                type: 'image_url',
+                image_url: { url: await imageFileToDataUri(params.firstFramePath) },
+                role: 'first_frame',
+            });
+        }
+        if (params.lastFramePath) {
+            content.push({
+                type: 'image_url',
+                image_url: { url: await imageFileToDataUri(params.lastFramePath) },
+                role: 'last_frame',
+            });
+        }
+        for (const path of params.referenceImagePaths ?? []) {
+            content.push({
+                type: 'image_url',
+                image_url: { url: await imageFileToDataUri(path) },
+                role: 'reference_image',
+            });
+        }
+        const body = {
+            model: remoteModelId,
+            content,
+            watermark: false,
+        };
+        if (params.resolution)
+            body.resolution = params.resolution;
+        if (params.aspectRatio)
+            body.ratio = params.aspectRatio;
+        if (params.durationSec != null)
+            body.duration = params.durationSec;
+        if (params.generateAudio != null)
+            body.generate_audio = params.generateAudio;
+        let res;
+        try {
+            res = await fetchImpl(`${provider.baseUrl}/contents/generations/tasks`, {
+                method: 'POST',
+                headers: bearerHeaders(provider.apiKey),
+                body: JSON.stringify(body),
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            throw ambiguousSubmitError();
+        }
+        if (!res.ok) {
+            if (res.status >= 500)
+                throw ambiguousSubmitError();
+            throw httpStatusError('ark', 'submit', res.status);
+        }
+        let taskId;
+        try {
+            const json = (await res.json());
+            taskId = json.id;
+        }
+        catch {
+            // Response said OK but wasn't JSON — treat as ambiguous rather than assume.
+            throw ambiguousSubmitError();
+        }
+        if (!taskId) {
+            // 2xx but no id: the task MAY exist server-side — this is ambiguous,
+            // not a clean failure, and must park the shot rather than re-submit.
+            throw new AmbiguousSubmitError('The provider accepted the request but returned no task id. Not retrying automatically; check the Ark console.', 'ark submit: no task id');
+        }
+        return {
+            taskId,
+            submittedAt: new Date().toISOString(),
+            requestFingerprint: requestFingerprint(remoteModelId, params),
+        };
+    },
+    async inspect(provider, handle, fetchImpl, signal) {
+        if (!provider.apiKey)
+            throw missingKeyError('ark', 'ARK_API_KEY', provider.apiKeyPath);
+        let res;
+        try {
+            res = await fetchImpl(`${provider.baseUrl}/contents/generations/tasks/${encodeURIComponent(handle.taskId)}`, {
+                headers: { authorization: `Bearer ${provider.apiKey}` },
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            throw networkError('ark', 'inspect');
+        }
+        if (!res.ok)
+            throw httpStatusError('ark', 'inspect', res.status);
+        const json = (await res.json());
+        switch (json.status) {
+            case 'queued':
+                return { phase: 'pending' };
+            case 'running':
+                return { phase: 'running' };
+            case 'succeeded': {
+                const videoUrl = json.content?.video_url;
+                if (!videoUrl) {
+                    throw new VideoGenError('The task succeeded but returned no video URL. Report this with the task id.', 'ark inspect: succeeded without url');
+                }
+                return { phase: 'succeeded', videoUrl };
+            }
+            case 'failed':
+                return { phase: 'failed', message: json.error?.message ?? 'unknown provider error' };
+            default:
+                throw new VideoGenError(`The provider returned an unknown task status. Task id kept for support: ${handle.taskId}.`, 'ark inspect: unknown status');
+        }
+    },
+    async downloadTo(_provider, _handle, videoUrl, destPath, fetchImpl, signal) {
+        try {
+            return await downloadFile({ url: videoUrl, destPath, fetchImpl, signal });
+        }
+        catch (error) {
+            if (error instanceof VideoGenError)
+                throw error;
+            throw new VideoGenError(`Downloading the video failed (${redactUrl(videoUrl)}). The URL expires after 24h — rerun to regenerate.`, 'ark download: failed');
+        }
+    },
+    // cancel: intentionally omitted — Ark task-cancellation support is unverified
+    // until the M0 probe reports. Local stops are surfaced as `polling_stopped`.
+};
+//# sourceMappingURL=ark.js.map

package/dist/providers/ark.js.map

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

package/dist/providers/dashscope.d.ts

@@ -0,0 +1,28 @@
+import type { VideoProviderAdapter } from '../types.js';
+/**
+ * Alibaba DashScope video generation (HappyHorse series).
+ *
+ *   POST {baseUrl}/api/v1/services/aigc/video-generation/video-synthesis
+ *        (headers: X-DashScope-Async: enable)   → output.task_id
+ *   GET  {baseUrl}/api/v1/tasks/{taskId}       → output.task_status / video_url
+ *   POST {baseUrl}/api/v1/tasks/{taskId}/cancel (generic DashScope task API)
+ *
+ * Model family routing (one logical model id maps to three real ones):
+ *   no images            → {family}-t2v
+ *   firstFramePath       → {family}-i2v   (exactly ONE first frame, ratio follows image)
+ *   referenceImagePaths  → {family}-r2v   (1-9 reference images, prompt uses [Image N])
+ * firstFrame + references together are NOT supported (i2v and r2v are distinct
+ * endpoints); last-frame interpolation does not exist on HappyHorse.
+ *
+ * Workspace note: the default baseUrl is the classic dashscope.aliyuncs.com,
+ * which needs NO workspace id. New Bailian workspaces use a per-workspace
+ * hostname — set providers.dashscope.baseUrl to
+ * https://{workspaceId}.cn-beijing.maas.aliyuncs.com — and aggregators speaking
+ * this wire format just point customProviders at themselves.
+ *
+ * Docs: https://help.aliyun.com/zh/model-studio/happyhorse-text-to-video-api-reference
+ * (and the image-to-video / reference-to-video siblings)
+ */
+export declare const DASHSCOPE_DEFAULT_BASE_URL = "https://dashscope.aliyuncs.com";
+export declare const dashscopeAdapter: VideoProviderAdapter;
+//# sourceMappingURL=dashscope.d.ts.map

package/dist/providers/dashscope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashscope.d.ts","sourceRoot":"","sources":["../../src/providers/dashscope.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAIV,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,eAAO,MAAM,0BAA0B,mCAAmC,CAAC;AAoC3E,eAAO,MAAM,gBAAgB,EAAE,oBAgL9B,CAAC"}

package/dist/providers/dashscope.js

@@ -0,0 +1,200 @@
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { AmbiguousSubmitError, httpStatusError, missingKeyError, networkError, safeBasename, VideoGenError, } from '../errors.js';
+import { requestFingerprint } from './request.js';
+import { downloadFile } from './task.js';
+/**
+ * Alibaba DashScope video generation (HappyHorse series).
+ *
+ *   POST {baseUrl}/api/v1/services/aigc/video-generation/video-synthesis
+ *        (headers: X-DashScope-Async: enable)   → output.task_id
+ *   GET  {baseUrl}/api/v1/tasks/{taskId}       → output.task_status / video_url
+ *   POST {baseUrl}/api/v1/tasks/{taskId}/cancel (generic DashScope task API)
+ *
+ * Model family routing (one logical model id maps to three real ones):
+ *   no images            → {family}-t2v
+ *   firstFramePath       → {family}-i2v   (exactly ONE first frame, ratio follows image)
+ *   referenceImagePaths  → {family}-r2v   (1-9 reference images, prompt uses [Image N])
+ * firstFrame + references together are NOT supported (i2v and r2v are distinct
+ * endpoints); last-frame interpolation does not exist on HappyHorse.
+ *
+ * Workspace note: the default baseUrl is the classic dashscope.aliyuncs.com,
+ * which needs NO workspace id. New Bailian workspaces use a per-workspace
+ * hostname — set providers.dashscope.baseUrl to
+ * https://{workspaceId}.cn-beijing.maas.aliyuncs.com — and aggregators speaking
+ * this wire format just point customProviders at themselves.
+ *
+ * Docs: https://help.aliyun.com/zh/model-studio/happyhorse-text-to-video-api-reference
+ * (and the image-to-video / reference-to-video siblings)
+ */
+export const DASHSCOPE_DEFAULT_BASE_URL = 'https://dashscope.aliyuncs.com';
+const MIME_BY_EXT = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+};
+async function imageFileToDataUri(path) {
+    const mime = MIME_BY_EXT[extname(path).toLowerCase()];
+    if (!mime) {
+        throw new VideoGenError(`Reference image must be png/jpg/webp: ${safeBasename(path)}`, 'dashscope: unsupported image extension');
+    }
+    let bytes;
+    try {
+        bytes = await readFile(path);
+    }
+    catch {
+        throw new VideoGenError(`Reference image is not readable: ${safeBasename(path)}`, 'dashscope: image unreadable');
+    }
+    return `data:${mime};base64,${bytes.toString('base64')}`;
+}
+function ambiguousSubmitError() {
+    return new AmbiguousSubmitError('Task creation failed with an ambiguous result (network error or server 5xx). The provider MAY have created a paid task — check the DashScope console before retrying to avoid double billing.', 'dashscope submit: ambiguous outcome');
+}
+export const dashscopeAdapter = {
+    async submit(provider, remoteModelId, params, fetchImpl, signal) {
+        if (!provider.apiKey) {
+            throw missingKeyError('dashscope', 'DASHSCOPE_API_KEY', provider.apiKeyPath);
+        }
+        if (params.lastFramePath) {
+            throw new VideoGenError('HappyHorse does not support last-frame interpolation. Remove lastFramePath.', 'dashscope: last frame unsupported');
+        }
+        if (params.firstFramePath && params.referenceImagePaths?.length) {
+            throw new VideoGenError('HappyHorse supports either a first frame (i2v) OR reference images (r2v), not both in one call.', 'dashscope: mixed frame and references');
+        }
+        // Model family routing: strip a trailing -t2v/-i2v/-r2v if the caller
+        // passed one, then re-derive from the actual params.
+        const family = remoteModelId.replace(/-(t2v|i2v|r2v)$/, '');
+        const media = [];
+        let model;
+        if (params.referenceImagePaths?.length) {
+            model = `${family}-r2v`;
+            for (const path of params.referenceImagePaths) {
+                media.push({ type: 'reference_image', url: await imageFileToDataUri(path) });
+            }
+        }
+        else if (params.firstFramePath) {
+            model = `${family}-i2v`;
+            media.push({ type: 'first_frame', url: await imageFileToDataUri(params.firstFramePath) });
+        }
+        else {
+            model = `${family}-t2v`;
+        }
+        const parameters = { watermark: false };
+        if (params.resolution)
+            parameters.resolution = params.resolution;
+        // i2v follows the frame's aspect ratio — ratio is rejected there.
+        if (params.aspectRatio && model !== `${family}-i2v`)
+            parameters.ratio = params.aspectRatio;
+        if (params.durationSec != null)
+            parameters.duration = params.durationSec;
+        const body = {
+            model,
+            input: { prompt: params.prompt, ...(media.length > 0 ? { media } : {}) },
+            parameters,
+        };
+        let res;
+        try {
+            res = await fetchImpl(`${provider.baseUrl}/api/v1/services/aigc/video-generation/video-synthesis`, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${provider.apiKey}`,
+                    'content-type': 'application/json',
+                    'x-dashscope-async': 'enable',
+                },
+                body: JSON.stringify(body),
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            throw ambiguousSubmitError();
+        }
+        if (!res.ok) {
+            if (res.status >= 500)
+                throw ambiguousSubmitError();
+            throw httpStatusError('dashscope', 'submit', res.status);
+        }
+        let taskId;
+        try {
+            const json = (await res.json());
+            taskId = json.output?.task_id;
+        }
+        catch {
+            throw ambiguousSubmitError();
+        }
+        if (!taskId) {
+            // 2xx but no id: the task MAY exist server-side — this is ambiguous,
+            // not a clean failure, and must park the shot rather than re-submit.
+            throw new AmbiguousSubmitError('The provider accepted the request but returned no task id. Not retrying automatically; check the DashScope console.', 'dashscope submit: no task id');
+        }
+        return {
+            taskId,
+            submittedAt: new Date().toISOString(),
+            requestFingerprint: requestFingerprint(remoteModelId, params),
+        };
+    },
+    async inspect(provider, handle, fetchImpl, signal) {
+        if (!provider.apiKey) {
+            throw missingKeyError('dashscope', 'DASHSCOPE_API_KEY', provider.apiKeyPath);
+        }
+        let res;
+        try {
+            res = await fetchImpl(`${provider.baseUrl}/api/v1/tasks/${encodeURIComponent(handle.taskId)}`, {
+                headers: { authorization: `Bearer ${provider.apiKey}` },
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            throw networkError('dashscope', 'inspect');
+        }
+        if (!res.ok)
+            throw httpStatusError('dashscope', 'inspect', res.status);
+        const json = (await res.json());
+        switch (json.output?.task_status) {
+            case 'PENDING':
+                return { phase: 'pending' };
+            case 'RUNNING':
+                return { phase: 'running' };
+            case 'SUCCEEDED': {
+                const videoUrl = json.output?.video_url;
+                if (!videoUrl) {
+                    throw new VideoGenError('The task succeeded but returned no video URL. Report this with the task id.', 'dashscope inspect: succeeded without url');
+                }
+                return { phase: 'succeeded', videoUrl };
+            }
+            case 'FAILED':
+                return { phase: 'failed', message: json.output?.message ?? 'unknown provider error' };
+            case 'CANCELED':
+                return { phase: 'failed', message: 'task was cancelled on the provider' };
+            case 'UNKNOWN':
+                return { phase: 'failed', message: 'task unknown or expired (task ids live 24h)' };
+            default:
+                throw new VideoGenError(`The provider returned an unknown task status. Task id kept for support: ${handle.taskId}.`, 'dashscope inspect: unknown status');
+        }
+    },
+    async downloadTo(_provider, _handle, videoUrl, destPath, fetchImpl, signal) {
+        // DashScope result URLs are signed OSS links (24h expiry); download promptly.
+        return downloadFile({ url: videoUrl, destPath, fetchImpl, signal });
+    },
+    /** Generic DashScope task cancellation: POST /api/v1/tasks/{id}/cancel. */
+    async cancel(provider, handle, fetchImpl, signal) {
+        if (!provider.apiKey) {
+            throw missingKeyError('dashscope', 'DASHSCOPE_API_KEY', provider.apiKeyPath);
+        }
+        let res;
+        try {
+            res = await fetchImpl(`${provider.baseUrl}/api/v1/tasks/${encodeURIComponent(handle.taskId)}/cancel`, {
+                method: 'POST',
+                headers: { authorization: `Bearer ${provider.apiKey}` },
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            throw networkError('dashscope', 'cancel');
+        }
+        if (!res.ok)
+            throw httpStatusError('dashscope', 'cancel', res.status);
+        return { cancelled: true };
+    },
+};
+//# sourceMappingURL=dashscope.js.map

package/dist/providers/dashscope.js.map

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

package/dist/providers/kling.d.ts

@@ -0,0 +1,46 @@
+import type { RemoteTaskHandle, VideoProviderAdapter } from '../types.js';
+/**
+ * Kling (Kuaishou) video generation — official Kling API 2.0.
+ *
+ *   POST {baseUrl}/text-to-video/{model}          { prompt, settings, options }
+ *   POST {baseUrl}/image-to-video/{model}         { contents, settings, options }
+ *   GET  {baseUrl}/tasks?task_ids={id}            → data[0].status / outputs[].url
+ *
+ * Verified against the official docs (kling.ai/document-api, 2026-07):
+ * - Auth: `Authorization: Bearer {apiKey}` — the older JWT ak/sk scheme is legacy.
+ * - The model lives in the PATH (`kling-3.0-turbo`, `kling-3.0`), not the body.
+ * - t2v takes a plain `prompt` string; i2v takes a `contents` array
+ *   (prompt + first_frame [+ last_frame]). i2v follows the frame's ratio, so
+ *   aspect_ratio is t2v-only.
+ * - `options.external_task_id` is a client-provided, account-unique id that is
+ *   QUERYABLE (GET /tasks?external_task_ids=…) — we set it to our request
+ *   fingerprint, so an ambiguous submit failure can be resolved by lookup
+ *   instead of blindly resubmitting a paid task. See recoverByExternalId().
+ * - Kling 3.0 (Omni) adds last_frame, audio: "native"|"off", and 4k; the 3.0
+ *   Turbo is first-frame-only and silent.
+ * - Default base is api-singapore.klingai.com (the documented current domain);
+ *   China-region accounts can point baseUrl at their regional endpoint.
+ */
+export declare const KLING_DEFAULT_BASE_URL = "https://api-singapore.klingai.com";
+type RecoverResult = {
+    outcome: 'found';
+    handle: RemoteTaskHandle;
+} | {
+    outcome: 'not-found';
+} | {
+    outcome: 'unknown';
+};
+export declare const klingAdapter: VideoProviderAdapter;
+/**
+ * Best-effort idempotency lookup with its OWN short timeout — the caller's
+ * signal may already be aborted (that's why we're here), and the lookup must
+ * still run to tell whether a paid task exists. Returns null on any failure;
+ * callers decide between CancelledError (user aborted) and ambiguous error.
+ */
+/** Exported for tests: the lookup deadline is injectable (default 10s). */
+export declare function tryRecoverByExternalId(provider: {
+    apiKey?: string | undefined;
+    baseUrl: string;
+}, fp: string, taskType: string, fetchImpl: typeof fetch, timeoutMs?: number): Promise<RecoverResult>;
+export {};
+//# sourceMappingURL=kling.d.ts.map

package/dist/providers/kling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kling.d.ts","sourceRoot":"","sources":["../../src/providers/kling.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,gBAAgB,EAGhB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,eAAO,MAAM,sBAAsB,sCAAsC,CAAC;AA4B1E,KAAK,aAAa,GACd;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,GAC9C;IAAE,OAAO,EAAE,WAAW,CAAA;CAAE,GACxB;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAmF3B,eAAO,MAAM,YAAY,EAAE,oBAuH1B,CAAC;AAEF;;;;;GAKG;AACH,2EAA2E;AAC3E,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC1D,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,KAAK,EACvB,SAAS,SAAS,GACjB,OAAO,CAAC,aAAa,CAAC,CAgCxB"}