@bitmagic/asset-core 0.1.0

package/dist/forger-client.d.ts

@@ -0,0 +1,42 @@
+import type { CoreLogger, ForgerClient } from './types.js';
+/**
+ * Asset Forger API client for authentication and request handling.
+ *
+ * Moved verbatim from game-play-agent; the only change is that the logger is
+ * injected so this package stays free of any host's logging stack.
+ */
+export interface AssetForgerCredentials {
+    username: string;
+    password: string;
+}
+export declare class AssetForgerClient implements ForgerClient {
+    private readonly baseUrl;
+    private readonly credentials;
+    private readonly log;
+    constructor(logger: CoreLogger);
+    hasCredentials(): boolean;
+    getMissingCredentialsMessage(): string;
+    private authHeader;
+    private postJson;
+    /**
+     * Make a POST request to an Asset Forger endpoint
+     *
+     * @param endpoint - API endpoint path (e.g., '/ai/v1/generate-image-as-webp-url')
+     * @param payload - Request payload (object or pre-serialized JSON string)
+     * @param loggerName - Name for logging (e.g., 'SkyboxImageGenerator')
+     * @returns Response JSON
+     */
+    post<T = unknown>(endpoint: string, payload: unknown, loggerName: string): Promise<T>;
+    /**
+     * Submit an async job and poll until it reaches a terminal state.
+     *
+     * POSTs `payload` to `jobsEndpoint` (expects 202 with `{jobId, statusUrl}`),
+     * then GETs `<baseUrl><statusUrl>` every ~5s with jitter until status is
+     * `succeeded` (returns `result.data`) or `failed` (throws). Transient poll
+     * failures (network errors, non-ok responses, JSON parse errors) are retried
+     * up to a small limit; the 404 race with the initial status-blob write in
+     * GCS just after job acceptance is covered by this retry path.
+     */
+    postJobAndWait<T = unknown>(jobsEndpoint: string, payload: unknown, loggerName: string): Promise<T>;
+}
+//# sourceMappingURL=forger-client.d.ts.map

package/dist/forger-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forger-client.d.ts","sourceRoot":"","sources":["../src/forger-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;GAKG;AAEH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,iBAAkB,YAAW,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiF;IACzG,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAa;gBAErB,MAAM,EAAE,UAAU;IAgBvB,cAAc,IAAI,OAAO;IAIzB,4BAA4B,IAAI,MAAM;IAI7C,OAAO,CAAC,UAAU;YAMJ,QAAQ;IAgCtB;;;;;;;OAOG;IACU,IAAI,CAAC,CAAC,GAAG,OAAO,EAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC;IAMb;;;;;;;;;OASG;IACU,cAAc,CAAC,CAAC,GAAG,OAAO,EACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC;CA+Ed"}

package/dist/forger-client.js

@@ -0,0 +1,135 @@
+export class AssetForgerClient {
+    constructor(logger) {
+        this.baseUrl = process.env.ASSET_FORGER_URL || 'https://asset-forger.staging.bitmagic.cloud';
+        this.log = logger;
+        const username = process.env.ASSET_FORGER_USER;
+        const password = process.env.ASSET_FORGER_PASSWORD;
+        this.log.info(`Initializing AssetForgerClient with URL: ${this.baseUrl}`);
+        if (username && password) {
+            this.credentials = { username, password };
+            this.log.info('Asset Forger credentials configured');
+        }
+        else {
+            this.credentials = null;
+            this.log.warn('Asset Forger credentials not found in environment variables');
+        }
+    }
+    hasCredentials() {
+        return this.credentials !== null;
+    }
+    getMissingCredentialsMessage() {
+        return 'Asset Forger credentials not found in environment variables. Please set ASSET_FORGER_USER and ASSET_FORGER_PASSWORD.';
+    }
+    authHeader() {
+        // Callers must check hasCredentials() first.
+        const { username, password } = this.credentials;
+        return `Basic ${btoa(`${username}:${password}`)}`;
+    }
+    async postJson(endpoint, payload, loggerName) {
+        if (!this.credentials) {
+            throw new Error('Asset Forger credentials not configured');
+        }
+        const url = `${this.baseUrl}${endpoint}`;
+        this.log.info(`[${loggerName}] POST ${url}`);
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': this.authHeader(),
+            },
+            body: typeof payload === 'string' ? payload : JSON.stringify(payload),
+        });
+        this.log.info(`[${loggerName}] API Response Status: ${response.status} ${response.statusText}`);
+        if (!response.ok) {
+            const errorText = await response.text();
+            this.log.error(`[${loggerName}] API Error Response:`, errorText);
+            throw new Error(`HTTP error! status: ${response.status}, message: ${errorText}`);
+        }
+        return await response.json();
+    }
+    /**
+     * Make a POST request to an Asset Forger endpoint
+     *
+     * @param endpoint - API endpoint path (e.g., '/ai/v1/generate-image-as-webp-url')
+     * @param payload - Request payload (object or pre-serialized JSON string)
+     * @param loggerName - Name for logging (e.g., 'SkyboxImageGenerator')
+     * @returns Response JSON
+     */
+    async post(endpoint, payload, loggerName) {
+        const json = await this.postJson(endpoint, payload, loggerName);
+        this.log.info(`[${loggerName}] Received response:`, json);
+        return json;
+    }
+    /**
+     * Submit an async job and poll until it reaches a terminal state.
+     *
+     * POSTs `payload` to `jobsEndpoint` (expects 202 with `{jobId, statusUrl}`),
+     * then GETs `<baseUrl><statusUrl>` every ~5s with jitter until status is
+     * `succeeded` (returns `result.data`) or `failed` (throws). Transient poll
+     * failures (network errors, non-ok responses, JSON parse errors) are retried
+     * up to a small limit; the 404 race with the initial status-blob write in
+     * GCS just after job acceptance is covered by this retry path.
+     */
+    async postJobAndWait(jobsEndpoint, payload, loggerName) {
+        const submitJson = await this.postJson(jobsEndpoint, payload, loggerName);
+        const { jobId, statusUrl } = submitJson;
+        if (!jobId || !statusUrl) {
+            throw new Error(`Job submission returned invalid response: ${JSON.stringify(submitJson)}`);
+        }
+        this.log.info(`[${loggerName}] Job ${jobId} accepted, polling ${statusUrl}...`);
+        const statusFullUrl = `${this.baseUrl}${statusUrl}`;
+        // Upstream's Python wrapper retries once after a per-attempt 300s timeout,
+        // so legitimate slow successes can take ~380s. Must exceed that ceiling.
+        const overallTimeoutMs = 8 * 60 * 1000;
+        const basePollMs = 5000;
+        const minPollMs = 2000;
+        const maxConsecutivePollErrors = 5;
+        const startTime = Date.now();
+        let consecutivePollErrors = 0;
+        for (;;) {
+            if (Date.now() - startTime > overallTimeoutMs) {
+                throw new Error(`Job ${jobId} exceeded client timeout of ${overallTimeoutMs}ms`);
+            }
+            // 5s ± 20% jitter, floored at 2s
+            const waitMs = Math.max(minPollMs, Math.round(basePollMs * (0.8 + Math.random() * 0.4)));
+            await new Promise(resolve => setTimeout(resolve, waitMs));
+            let statusJson;
+            try {
+                const statusResponse = await fetch(statusFullUrl, {
+                    method: 'GET',
+                    headers: { 'Authorization': this.authHeader() },
+                });
+                if (!statusResponse.ok) {
+                    const errorText = await statusResponse.text().catch(() => '');
+                    throw new Error(`non-ok ${statusResponse.status}: ${errorText}`);
+                }
+                statusJson = await statusResponse.json();
+                consecutivePollErrors = 0;
+            }
+            catch (err) {
+                consecutivePollErrors += 1;
+                const errMsg = err instanceof Error ? err.message : String(err);
+                if (consecutivePollErrors >= maxConsecutivePollErrors) {
+                    throw new Error(`Job ${jobId} polling failed: ${consecutivePollErrors} consecutive errors. Last: ${errMsg}`);
+                }
+                this.log.warn(`[${loggerName}] Status poll error (${consecutivePollErrors}/${maxConsecutivePollErrors}), will retry: ${errMsg}`);
+                continue;
+            }
+            if (statusJson.status === 'succeeded') {
+                this.log.info(`[${loggerName}] Job ${jobId} succeeded`);
+                if (!statusJson.result) {
+                    throw new Error(`Job ${jobId} succeeded but has no result`);
+                }
+                return statusJson.result;
+            }
+            if (statusJson.status === 'failed') {
+                const errStr = typeof statusJson.error === 'string'
+                    ? statusJson.error
+                    : JSON.stringify(statusJson.error ?? 'unknown error');
+                const httpPart = statusJson.httpStatus ? ` (httpStatus=${statusJson.httpStatus})` : '';
+                throw new Error(`Job ${jobId} failed${httpPart}: ${errStr}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=forger-client.js.map

package/dist/forger-client.js.map

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

package/dist/generators/animation.d.ts

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+/**
+ * `process.env.ANIMATION_MODEL` is the one env read this package gains beyond
+ * `forger-client.ts`'s existing `ASSET_FORGER_*` reads. It is not a violation
+ * of "no module globals": it configures the upstream call itself (which
+ * animation model asset-forger receives), exactly like the Forger URL and
+ * credentials env reads in `forger-client.ts`. It is read once per generation
+ * call, not cached at module load, so it stays test- and CLI-friendly.
+ */
+/**
+ * The text-to-motion-3.0 model constrains animation length to 4-8 seconds;
+ * out-of-range values are clamped in buildRequest below.
+ */
+export declare const ANIMATION_MODEL_TEXT_TO_MOTION_3 = "text-to-motion-3.0";
+/** The older, faster model — also the fallback when text-to-motion-3.0 fails. */
+export declare const ANIMATION_MODEL_TEXT_TO_MOTION_2 = "text-to-motion-2.0";
+/**
+ * UI/request sentinel meaning "the older, faster model" (text-to-motion-2.0).
+ * Distinct from an absent override, which inherits the ANIMATION_MODEL env
+ * default. Used by the generate-animation tool's per-request override.
+ */
+export declare const ANIMATION_MODEL_OLDER = "older";
+/**
+ * Model for the asset-forger animation generator. Defaults to
+ * text-to-motion-3.0 when `ANIMATION_MODEL` is unset. Set `ANIMATION_MODEL`
+ * to another model id (or `older` for text-to-motion-2.0) to override.
+ */
+export declare function getConfiguredAnimationModel(): string;
+export declare const animationParamsSchema: z.ZodObject<{
+    description: z.ZodString;
+    cfgScale: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    length: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
+    footIk: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    inPlace: z.ZodOptional<z.ZodBoolean>;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    assetId: z.ZodOptional<z.ZodString>;
+    /**
+     * Explicit per-request model override, e.g. from the game-play-agent
+     * runtimeContext's `animationModel`. `undefined` inherits the
+     * ANIMATION_MODEL-configured default. Not part of the LLM-facing tool
+     * schema — the adapter resolves this from its own session state and passes
+     * it through.
+     */
+    model: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    description: string;
+    cfgScale: number;
+    footIk: boolean;
+    length?: number | undefined;
+    loop?: boolean | undefined;
+    assetId?: string | undefined;
+    seed?: number | undefined;
+    inPlace?: boolean | undefined;
+    model?: string | undefined;
+}, {
+    description: string;
+    length?: number | undefined;
+    loop?: boolean | undefined;
+    assetId?: string | undefined;
+    cfgScale?: number | undefined;
+    seed?: number | undefined;
+    footIk?: boolean | undefined;
+    inPlace?: boolean | undefined;
+    model?: string | undefined;
+}>;
+/**
+ * The schema's INPUT type — callers may omit the defaulted fields. The
+ * generator parses on entry and works with the output type internally, which
+ * is what lets it own its own defaults instead of each host patching them in.
+ */
+export type AnimationParams = z.input<typeof animationParamsSchema>;
+export type AnimationResult = AssetResultBase & {
+    animationUrl?: string;
+    /** The id the animation was stored under: `assetId` when supplied, else the generator's own motionId. */
+    motionId?: string;
+    /**
+     * Resolved animation length in seconds actually sent to asset-forger for the
+     * attempt that succeeded (after defaults and text-to-motion-3.0 clamping).
+     * The adapter passes this as `units` to `reportToolExecution` for
+     * per-second billing — it must reflect the duration actually generated.
+     */
+    lengthSeconds?: number;
+    /**
+     * Model actually used by the successful attempt (absent on total failure,
+     * since no attempt succeeded). The adapter passes this as `model` to
+     * `reportToolExecution`, which resolves the per-second rate via
+     * `cost_per_second_by_model[model] ?? cost_per_second`.
+     */
+    model?: string;
+    /**
+     * True once a response with a resolvable animation URL was received.
+     * Left unset on any failure — including "the Forger responded but with no
+     * URL" — matching the original tool, which never billed a fully-failed
+     * generation (unlike the job-based character/skybox generators, this
+     * endpoint answers synchronously with no separate "job accepted" moment).
+     */
+    billable?: boolean;
+};
+export declare function generateAnimationAsset(params: AnimationParams, deps: GenerateDeps): Promise<AnimationResult>;
+//# sourceMappingURL=animation.d.ts.map

package/dist/generators/animation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.d.ts","sourceRoot":"","sources":["../../src/generators/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAA4B,YAAY,EAAc,MAAM,aAAa,CAAC;AAIvG;;;;;;;GAOG;AAEH;;;GAGG;AACH,eAAO,MAAM,gCAAgC,uBAAuB,CAAC;AAIrE,iFAAiF;AACjF,eAAO,MAAM,gCAAgC,uBAAuB,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UAAU,CAAC;AAe7C;;;;GAIG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAMpD;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;IAiBhC;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;EAGM,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yGAAyG;IACzG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAwIF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,eAAe,CAAC,CAwF1B"}

package/dist/generators/animation.js

@@ -0,0 +1,234 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { formatZodIssues } from '../validation.js';
+/**
+ * `process.env.ANIMATION_MODEL` is the one env read this package gains beyond
+ * `forger-client.ts`'s existing `ASSET_FORGER_*` reads. It is not a violation
+ * of "no module globals": it configures the upstream call itself (which
+ * animation model asset-forger receives), exactly like the Forger URL and
+ * credentials env reads in `forger-client.ts`. It is read once per generation
+ * call, not cached at module load, so it stays test- and CLI-friendly.
+ */
+/**
+ * The text-to-motion-3.0 model constrains animation length to 4-8 seconds;
+ * out-of-range values are clamped in buildRequest below.
+ */
+export const ANIMATION_MODEL_TEXT_TO_MOTION_3 = 'text-to-motion-3.0';
+const TEXT_TO_MOTION_3_MIN_LENGTH = 4;
+const TEXT_TO_MOTION_3_MAX_LENGTH = 8;
+/** The older, faster model — also the fallback when text-to-motion-3.0 fails. */
+export const ANIMATION_MODEL_TEXT_TO_MOTION_2 = 'text-to-motion-2.0';
+/**
+ * UI/request sentinel meaning "the older, faster model" (text-to-motion-2.0).
+ * Distinct from an absent override, which inherits the ANIMATION_MODEL env
+ * default. Used by the generate-animation tool's per-request override.
+ */
+export const ANIMATION_MODEL_OLDER = 'older';
+const DEFAULT_LENGTH_SECONDS = 3;
+const FIXED_STEPS = 100;
+// Per-attempt timeouts. text-to-motion-3.0 clips can take ~2.5min+ server-side
+// (and retry internally in asset-forger), so it gets a generous 10min; the
+// text-to-motion-2.0 fallback is faster, so 3min. Legacy non-T2M3 path stays at 6min.
+const T2M3_TIMEOUT_MS = 600000; // 10 minutes
+const FALLBACK_TIMEOUT_MS = 180000; // 3 minutes
+const LEGACY_TIMEOUT_MS = 360000; // 6 minutes
+const RETRY_DELAY_MS = 2000;
+const ENDPOINT = '/ai/v1/generate-animation-as-glb-url';
+/**
+ * Model for the asset-forger animation generator. Defaults to
+ * text-to-motion-3.0 when `ANIMATION_MODEL` is unset. Set `ANIMATION_MODEL`
+ * to another model id (or `older` for text-to-motion-2.0) to override.
+ */
+export function getConfiguredAnimationModel() {
+    const configured = process.env.ANIMATION_MODEL;
+    if (configured === ANIMATION_MODEL_OLDER) {
+        return ANIMATION_MODEL_TEXT_TO_MOTION_2;
+    }
+    return configured || ANIMATION_MODEL_TEXT_TO_MOTION_3;
+}
+export const animationParamsSchema = z.object({
+    description: z.string().min(1)
+        .describe('Simple action phrase describing the animation (e.g., "A person swimming slowly")'),
+    cfgScale: z.number().optional().default(6.0)
+        .describe('Classifier-free guidance scale (higher = more prompt adherence). Defaults to 6.0.'),
+    length: z.number().optional()
+        .describe('Animation length in seconds. Defaults to 3.0. Note: the text-to-motion-3.0 model only supports 4–8s (out-of-range values are clamped).'),
+    seed: z.number().optional()
+        .describe('Random seed for reproducibility. Omit for random results.'),
+    footIk: z.boolean().optional().default(true)
+        .describe('Enable foot IK (inverse kinematics) for grounded animations. Defaults to true. Set to false for airborne animations like jumping.'),
+    inPlace: z.boolean().optional()
+        .describe('Generate animation where the character stays in place (e.g., idle animations). Defaults to false.'),
+    loop: z.boolean().optional()
+        .describe('Whether the animation should loop continuously. Set to true for idle animations. Defaults to false.'),
+    assetId: z.string().optional()
+        .describe('Pre-generated asset id from the manifest. When provided, the animation is stored under this exact id (used as its motionId for playCustomAnimation) so code that references it resolves. If omitted, the generator motionId is used.'),
+    /**
+     * Explicit per-request model override, e.g. from the game-play-agent
+     * runtimeContext's `animationModel`. `undefined` inherits the
+     * ANIMATION_MODEL-configured default. Not part of the LLM-facing tool
+     * schema — the adapter resolves this from its own session state and passes
+     * it through.
+     */
+    model: z.string().optional()
+        .describe('Explicit model override for this call. Omit to use the configured ANIMATION_MODEL default.'),
+}).strict();
+/**
+ * Resolve which model this call should start with: an explicit per-request
+ * `model` override wins (`text-to-motion-3.0` names that model directly,
+ * `older` forces text-to-motion-2.0 even over an ANIMATION_MODEL=3.0 env
+ * default); any other value (including absent) inherits the configured
+ * default. An unrecognized override string is not treated as an explicit
+ * model id — it falls through to the env default, matching the original
+ * tool's behaviour.
+ */
+function resolveEffectiveModel(modelOverride) {
+    if (modelOverride === ANIMATION_MODEL_TEXT_TO_MOTION_3) {
+        return ANIMATION_MODEL_TEXT_TO_MOTION_3;
+    }
+    if (modelOverride === ANIMATION_MODEL_OLDER) {
+        return ANIMATION_MODEL_TEXT_TO_MOTION_2;
+    }
+    return getConfiguredAnimationModel();
+}
+/**
+ * Attempt plan for a resolved starting model. text-to-motion-3.0 retries
+ * internally in asset-forger, so we NEVER retry it client-side; instead, on
+ * failure we fall back to text-to-motion-2.0 for a single attempt. Any other
+ * configured model keeps the legacy 2-attempt retry (same model twice).
+ */
+function buildAttemptPlan(effectiveModel) {
+    if (effectiveModel === ANIMATION_MODEL_TEXT_TO_MOTION_3) {
+        return [
+            { model: ANIMATION_MODEL_TEXT_TO_MOTION_3, label: ANIMATION_MODEL_TEXT_TO_MOTION_3, timeoutMs: T2M3_TIMEOUT_MS },
+            { model: ANIMATION_MODEL_TEXT_TO_MOTION_2, label: `${ANIMATION_MODEL_TEXT_TO_MOTION_2}-fallback`, timeoutMs: FALLBACK_TIMEOUT_MS },
+        ];
+    }
+    return [
+        { model: effectiveModel, label: effectiveModel, timeoutMs: LEGACY_TIMEOUT_MS },
+        { model: effectiveModel, label: `${effectiveModel}-retry`, timeoutMs: LEGACY_TIMEOUT_MS },
+    ];
+}
+/**
+ * Builds the resolved asset-forger request for one attempt (applies the
+ * text-to-motion-3.0 length clamp). Returning the object (rather than only a
+ * JSON string) lets the caller read the resolved length/model back for
+ * per-second billing without re-parsing what was sent.
+ */
+function buildRequest(input, model, logger) {
+    const payload = {
+        prompt: input.description,
+        format: 'glb',
+        model,
+        bucmd: true,
+        footIk: input.footIk,
+        length: input.length ?? DEFAULT_LENGTH_SECONDS,
+        cfgScale: input.cfgScale,
+        steps: FIXED_STEPS,
+        ...(input.seed !== undefined && { seed: input.seed }),
+        ...(input.inPlace !== undefined && { inPlace: input.inPlace }),
+    };
+    // text-to-motion-3.0 only accepts 4-8s clips. Clamp the resolved length into
+    // range; other models (including the text-to-motion-2.0 fallback) send it
+    // as-is.
+    if (model === ANIMATION_MODEL_TEXT_TO_MOTION_3) {
+        const clamped = Math.min(TEXT_TO_MOTION_3_MAX_LENGTH, Math.max(TEXT_TO_MOTION_3_MIN_LENGTH, payload.length));
+        if (clamped !== payload.length) {
+            logger.info(`[animation] Clamped length ${payload.length}s -> ${clamped}s for ${model} (allowed ${TEXT_TO_MOTION_3_MIN_LENGTH}-${TEXT_TO_MOTION_3_MAX_LENGTH}s)`);
+            payload.length = clamped;
+        }
+    }
+    return payload;
+}
+function withTimeout(promise, timeoutMs) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`Animation generation timed out after ${timeoutMs / 60000} minutes`)), timeoutMs);
+    });
+    // Clearing the loser's timer matters beyond tidiness: an un-cleared 10-minute
+    // timeout keeps the process (and a test runner's event loop) alive long after
+    // every real attempt has already settled.
+    return Promise.race([promise, timeout]).finally(() => clearTimeout(timer));
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function requestAnimation(forger, requestPayload, logger) {
+    logger.info({ payload: requestPayload }, '[animation] Request payload');
+    const response = await forger.post(ENDPOINT, JSON.stringify(requestPayload), 'AnimationGenerator');
+    if (!response.animationUrl) {
+        throw new Error('No animation URL found in API response');
+    }
+    return { animationUrl: response.animationUrl, motionId: response.motionId };
+}
+export async function generateAnimationAsset(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = animationParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[animation] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    if (!forger.hasCredentials()) {
+        logger.error('[animation] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    onProgress(`Generating animation: "${input.description}"`);
+    logger.info(`[animation] Starting generation for: "${input.description}"`);
+    const effectiveModel = resolveEffectiveModel(input.model);
+    const usingTextToMotion3 = effectiveModel === ANIMATION_MODEL_TEXT_TO_MOTION_3;
+    const attempts = buildAttemptPlan(effectiveModel);
+    let lastError = null;
+    for (let attempt = 0; attempt < attempts.length; attempt++) {
+        const { model, label, timeoutMs } = attempts[attempt];
+        const requestPayload = buildRequest(input, model, logger);
+        try {
+            const { animationUrl, motionId } = await withTimeout(requestAnimation(forger, requestPayload, logger), timeoutMs);
+            logger.info(`[animation] Successfully generated animation GLB URL: ${animationUrl}`);
+            logger.info(`[animation] Motion ID: ${motionId}`);
+            // The engine derives motionId from the asset id (see mergeGameData in
+            // game/src/types/game.ts) and loads the clip by URL, so honoring a
+            // pre-generated id from the manifest makes code that references it (via
+            // playCustomAnimation("<id>")) resolve. Falls back to the generator's
+            // own motionId when no id was pre-minted.
+            const finalMotionId = input.assetId ?? motionId;
+            const patch = {
+                type: 'pushRoot',
+                path: ['assets'],
+                value: {
+                    id: finalMotionId,
+                    name: input.description,
+                    url: animationUrl,
+                    type: 'animation',
+                    prompt: input.description,
+                    source: 'generated',
+                    size: 0,
+                    ...(input.loop !== undefined && { loop: input.loop }),
+                },
+            };
+            return ok(`Animation generated: ${animationUrl}`, [patch], {
+                animationUrl,
+                motionId: finalMotionId,
+                lengthSeconds: requestPayload.length,
+                model,
+                billable: true,
+            });
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error('Unknown error occurred');
+            logger.error({ err: lastError }, `[animation] ${label} attempt failed`);
+        }
+        if (attempt < attempts.length - 1) {
+            const next = attempts[attempt + 1];
+            const reason = usingTextToMotion3
+                ? `${label} failed, falling back to ${next.label}`
+                : `attempt ${attempt + 1} failed, retrying`;
+            logger.warn(`[animation] ${reason} in ${RETRY_DELAY_MS}ms...`);
+            await sleep(RETRY_DELAY_MS);
+        }
+    }
+    const message = lastError?.message ?? 'Failed to generate animation';
+    logger.error({ err: lastError }, `[animation] Generation failed after ${attempts.length} attempts`);
+    return fail(message);
+}
+//# sourceMappingURL=animation.js.map

package/dist/generators/animation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation.js","sourceRoot":"","sources":["../../src/generators/animation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,oBAAoB,CAAC;AACrE,MAAM,2BAA2B,GAAG,CAAC,CAAC;AACtC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAEtC,iFAAiF;AACjF,MAAM,CAAC,MAAM,gCAAgC,GAAG,oBAAoB,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC;AAE7C,MAAM,sBAAsB,GAAG,CAAC,CAAC;AACjC,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB,+EAA+E;AAC/E,2EAA2E;AAC3E,sFAAsF;AACtF,MAAM,eAAe,GAAG,MAAM,CAAC,CAAC,aAAa;AAC7C,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAC,YAAY;AAChD,MAAM,iBAAiB,GAAG,MAAM,CAAC,CAAC,YAAY;AAC9C,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B,MAAM,QAAQ,GAAG,sCAAsC,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,2BAA2B;IACzC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC/C,IAAI,UAAU,KAAK,qBAAqB,EAAE,CAAC;QACzC,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,UAAU,IAAI,gCAAgC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SAC3B,QAAQ,CAAC,kFAAkF,CAAC;IAC/F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;SACzC,QAAQ,CAAC,mFAAmF,CAAC;IAChG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC1B,QAAQ,CAAC,wIAAwI,CAAC;IACrJ,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACxB,QAAQ,CAAC,2DAA2D,CAAC;IACxE,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;SACzC,QAAQ,CAAC,mIAAmI,CAAC;IAChJ,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAC5B,QAAQ,CAAC,mGAAmG,CAAC;IAChH,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,qGAAqG,CAAC;IAClH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC3B,QAAQ,CAAC,sOAAsO,CAAC;IACnP;;;;;;OAMG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACzB,QAAQ,CAAC,4FAA4F,CAAC;CAC1G,CAAC,CAAC,MAAM,EAAE,CAAC;AAgEZ;;;;;;;;GAQG;AACH,SAAS,qBAAqB,CAAC,aAAiC;IAC9D,IAAI,aAAa,KAAK,gCAAgC,EAAE,CAAC;QACvD,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,IAAI,aAAa,KAAK,qBAAqB,EAAE,CAAC;QAC5C,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,2BAA2B,EAAE,CAAC;AACvC,CAAC;AAED;;;;;GAKG;AACH,SAAS,gBAAgB,CAAC,cAAsB;IAC9C,IAAI,cAAc,KAAK,gCAAgC,EAAE,CAAC;QACxD,OAAO;YACL,EAAE,KAAK,EAAE,gCAAgC,EAAE,KAAK,EAAE,gCAAgC,EAAE,SAAS,EAAE,eAAe,EAAE;YAChH,EAAE,KAAK,EAAE,gCAAgC,EAAE,KAAK,EAAE,GAAG,gCAAgC,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAE;SACnI,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,EAAE;QAC9E,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,cAAc,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE;KAC1F,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,KAA2B,EAAE,KAAa,EAAE,MAAkB;IAClF,MAAM,OAAO,GAAgC;QAC3C,MAAM,EAAE,KAAK,CAAC,WAAW;QACzB,MAAM,EAAE,KAAK;QACb,KAAK;QACL,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,sBAAsB;QAC9C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,WAAW;QAClB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACrD,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;KAC/D,CAAC;IAEF,6EAA6E;IAC7E,0EAA0E;IAC1E,SAAS;IACT,IAAI,KAAK,KAAK,gCAAgC,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,2BAA2B,EAAE,IAAI,CAAC,GAAG,CAAC,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7G,IAAI,OAAO,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,8BAA8B,OAAO,CAAC,MAAM,QAAQ,OAAO,SAAS,KAAK,aAAa,2BAA2B,IAAI,2BAA2B,IAAI,CAAC,CAAC;YAClK,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAI,OAAmB,EAAE,SAAiB;IAC5D,IAAI,KAAoC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC3C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wCAAwC,SAAS,GAAG,KAAK,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC9H,CAAC,CAAC,CAAC;IACH,8EAA8E;IAC9E,8EAA8E;IAC9E,0CAA0C;IAC1C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,MAAoB,EACpB,cAA2C,EAC3C,MAAkB;IAElB,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,6BAA6B,CAAC,CAAC;IAExE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,EAC9B,oBAAoB,CACrB,CAAC;IAEF,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,MAAuB,EACvB,IAAkB;IAElB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE5C,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,gCAAgC,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAE1B,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,UAAU,CAAC,0BAA0B,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;IAC3D,MAAM,CAAC,IAAI,CAAC,yCAAyC,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;IAE3E,MAAM,cAAc,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,kBAAkB,GAAG,cAAc,KAAK,gCAAgC,CAAC;IAC/E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;IAElD,IAAI,SAAS,GAAiB,IAAI,CAAC;IAEnC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC;QAC3D,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAE1D,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,MAAM,WAAW,CAClD,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,EAChD,SAAS,CACV,CAAC;YAEF,MAAM,CAAC,IAAI,CAAC,yDAAyD,YAAY,EAAE,CAAC,CAAC;YACrF,MAAM,CAAC,IAAI,CAAC,0BAA0B,QAAQ,EAAE,CAAC,CAAC;YAElD,sEAAsE;YACtE,mEAAmE;YACnE,wEAAwE;YACxE,sEAAsE;YACtE,0CAA0C;YAC1C,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC;YAEhD,MAAM,KAAK,GAAe;gBACxB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,KAAK,EAAE;oBACL,EAAE,EAAE,aAAa;oBACjB,IAAI,EAAE,KAAK,CAAC,WAAW;oBACvB,GAAG,EAAE,YAAY;oBACjB,IAAI,EAAE,WAAW;oBACjB,MAAM,EAAE,KAAK,CAAC,WAAW;oBACzB,MAAM,EAAE,WAAW;oBACnB,IAAI,EAAE,CAAC;oBACP,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;iBACtD;aACF,CAAC;YAEF,OAAO,EAAE,CACP,wBAAwB,YAAY,EAAE,EACtC,CAAC,KAAK,CAAC,EACP;gBACE,YAAY;gBACZ,QAAQ,EAAE,aAAa;gBACvB,aAAa,EAAE,cAAc,CAAC,MAAM;gBACpC,KAAK;gBACL,QAAQ,EAAE,IAAI;aACf,CACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACjF,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,eAAe,KAAK,iBAAiB,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;YACnC,MAAM,MAAM,GAAG,kBAAkB;gBAC/B,CAAC,CAAC,GAAG,KAAK,4BAA4B,IAAI,CAAC,KAAK,EAAE;gBAClD,CAAC,CAAC,WAAW,OAAO,GAAG,CAAC,mBAAmB,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,eAAe,MAAM,OAAO,cAAc,OAAO,CAAC,CAAC;YAC/D,MAAM,KAAK,CAAC,cAAc,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,SAAS,EAAE,OAAO,IAAI,8BAA8B,CAAC;IACrE,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,uCAAuC,QAAQ,CAAC,MAAM,WAAW,CAAC,CAAC;IACpG,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC"}

package/dist/generators/character.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+export declare const characterParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    prompt: z.ZodString;
+    applyToPlayer: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    headScale: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    assetId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    name: string;
+    applyToPlayer: boolean;
+    headScale: number;
+    assetId?: string | undefined;
+}, {
+    prompt: string;
+    name: string;
+    assetId?: string | undefined;
+    applyToPlayer?: boolean | undefined;
+    headScale?: number | undefined;
+}>;
+/**
+ * The schema's INPUT type — callers may omit the defaulted fields. The
+ * generator parses on entry and works with the output type internally, which
+ * is what lets it own its own defaults instead of each host patching them in.
+ */
+export type CharacterParams = z.input<typeof characterParamsSchema>;
+export type CharacterResult = AssetResultBase & {
+    assetId?: string;
+    characterUrl?: string;
+    /**
+     * True once the Asset Forger has accepted the rigged-character job — the
+     * vendor bills on acceptance, so a downstream failure (no resolvable URL)
+     * still costs. Left unset when the job submission itself threw, which is
+     * how the tool has always billed.
+     */
+    billable?: boolean;
+};
+export declare function generateCharacter(params: CharacterParams, deps: GenerateDeps): Promise<CharacterResult>;
+//# sourceMappingURL=character.d.ts.map

package/dist/generators/character.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../src/generators/character.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAc,MAAM,aAAa,CAAC;AAI7E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAqBvB,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAWF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,eAAe,CAAC,CA6H1B"}