@bitmagic/asset-core 0.1.0

package/dist/generators/character.js

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { formatZodIssues } from '../validation.js';
+export const characterParamsSchema = z.object({
+    name: z.string()
+        .min(1)
+        .regex(/^[a-zA-Z][a-zA-Z0-9_]*$/, 'Name must start with a letter, contain only letters, numbers, underscores')
+        .describe('Unique name for the character (e.g., "wizard", "goblin_warrior")'),
+    prompt: z.string()
+        .min(1)
+        .describe('Description of the character (e.g., "a wizard in a blue robe with a pointy hat")'),
+    applyToPlayer: z.boolean()
+        .optional()
+        .default(true)
+        .describe('Set this character as the PLAYER (writes worldProfileData.characterUrl and reloads). Set false for an NPC character — then pass character_url to the NPC spawn.'),
+    headScale: z.number()
+        .min(50)
+        .max(300)
+        .optional()
+        .default(150)
+        .describe('Head size as a percentage of normal (150 = chibi house style, matches the default character; 100 = realistic proportions).'),
+    assetId: z.string()
+        .optional()
+        .describe('Pre-generated asset id from the manifest. The character is stored in world.json assets[] under this id so code can reference it via registerNpc({ characterAssetId }).'),
+}).strict();
+const ENDPOINT = '/ai/v1/generate-rigged-character/jobs';
+export async function generateCharacter(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = characterParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[character] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    if (!forger.hasCredentials()) {
+        logger.error('[character] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    onProgress(`Generating character: ${input.name}`);
+    logger.info(`[character] Starting generation for "${input.name}"`);
+    // Proven recipe for an engine-ready character: rerigTarget 'default' => Mixamo
+    // Y-up rig the engine retarget drives correctly (NEVER 'ue5' — that rig renders
+    // mangled), voxelize => returns the rigged voxel GLB directly (no browser
+    // voxelization needed).
+    let forgeResult;
+    try {
+        forgeResult = await forger.postJobAndWait(ENDPOINT, {
+            prompt: input.prompt,
+            rerigTarget: 'default',
+            voxelize: true,
+            voxelsTall: 80,
+            voxelMode: 'blended',
+            headScale: input.headScale,
+        }, 'CharacterGeneration');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        logger.error({ err: error }, '[character] Error during generation');
+        return fail(message);
+    }
+    // Job accepted by Asset Forger — cost incurred regardless of downstream success.
+    const billable = true;
+    // Resolve the VOXELIZED rigged variant. The AF emits the voxel as
+    // `output-variant-N.glb` (COLOR_0 vertex colors — matches the voxel game's art
+    // style). Some Asset Forger deployments (the dev one) return ONLY the textured
+    // low-poly mesh (`output-low.glb`) in additionalOutputFileUrls, with the voxel
+    // variant sitting alongside it in the same bucket dir but not listed in the
+    // response. So: prefer an explicit variant URL; otherwise derive it from the
+    // returned URL's directory and probe `output-variant-N.glb`.
+    const outputs = forgeResult.data?.additionalOutputFileUrls ?? [];
+    let characterUrl = outputs.find((u) => /output-variant-\d+\.glb/i.test(u));
+    const baseUrl = outputs[0] ?? forgeResult.data?.fileUrl;
+    if (!characterUrl && baseUrl) {
+        const dir = baseUrl.replace(/[^/]+$/, '');
+        const probes = await Promise.all([1, 2, 3, 4].map(async (n) => {
+            const cand = `${dir}output-variant-${n}.glb`;
+            try {
+                return (await fetch(cand, { method: 'HEAD' })).ok ? cand : null;
+            }
+            catch {
+                return null;
+            }
+        }));
+        characterUrl = probes.filter((u) => u !== null).pop();
+        if (!characterUrl) {
+            logger.warn({ baseUrl }, '[character] No output-variant voxel found; falling back to AF-returned URL (may be a non-voxel mesh)');
+            characterUrl = baseUrl;
+        }
+    }
+    if (!characterUrl) {
+        return {
+            ...fail('Asset Forger returned no character URL. Ensure rerigTarget:"default" + voxelize:true are supported by the configured ASSET_FORGER_URL.'),
+            billable,
+        };
+    }
+    logger.info({ characterUrl, outputs }, '[character] Resolved voxel character URL');
+    // Store the character under its pre-minted manifest id so code can reference it
+    // via registerNpc({ characterAssetId }) — the engine resolves the id from
+    // assets[] at registration time. This is what lets the coding subagent run in
+    // parallel with asset generation instead of waiting for the literal GLB url.
+    const patches = [];
+    if (input.assetId) {
+        patches.push({
+            type: 'pushRoot',
+            path: ['assets'],
+            value: {
+                id: input.assetId,
+                name: input.name,
+                url: characterUrl,
+                type: 'character',
+                prompt: input.prompt,
+                source: 'generated',
+            },
+        });
+    }
+    // Apply to the player by writing worldProfileData.characterUrl AND
+    // useHighResCharacter:true — the default player look is the clean block
+    // mascot, so this flag is what makes PlayerLoader render the generated GLB as
+    // a highres skinned mesh on demand. The write triggers a game reload so it
+    // takes effect.
+    //
+    // The characterUrl write is authoritative: it is what makes the player render
+    // highres (a non-empty characterUrl ⇒ skinned unless useHighResCharacter:false),
+    // and it triggers the single reload. The useHighResCharacter flag is written
+    // FIRST as a best-effort marker (skipReload) so that if EITHER write fails the
+    // result is still consistent: flag-only with no URL → clean block; URL-only
+    // without the flag → still highres (the flag defaults to true when a custom
+    // URL is present).
+    if (input.applyToPlayer) {
+        patches.push({ type: 'set', path: ['useHighResCharacter'], value: true, skipReload: true }, { type: 'set', path: ['characterUrl'], value: characterUrl });
+    }
+    return ok(`Character "${input.name}" generated: ${characterUrl}`, patches, { assetId: input.assetId, characterUrl, billable });
+}
+//# sourceMappingURL=character.js.map

package/dist/generators/character.js.map

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

package/dist/generators/image.d.ts

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+export declare const imageAssetParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    prompt: z.ZodString;
+    width: z.ZodDefault<z.ZodNumber>;
+    height: z.ZodDefault<z.ZodNumber>;
+    referenceImageUrl: z.ZodOptional<z.ZodString>;
+    assetId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    name: string;
+    width: number;
+    height: number;
+    referenceImageUrl?: string | undefined;
+    assetId?: string | undefined;
+}, {
+    prompt: string;
+    name: string;
+    referenceImageUrl?: string | undefined;
+    assetId?: string | undefined;
+    width?: number | undefined;
+    height?: number | undefined;
+}>;
+/**
+ * The schema's INPUT type — callers may omit the defaulted dimensions. 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 ImageAssetParams = z.input<typeof imageAssetParamsSchema>;
+export type ImageAssetResult = AssetResultBase & {
+    assetId?: string;
+    name?: string;
+    url?: string;
+    /**
+     * True once the Forger has answered — the call is chargeable even when the
+     * response carried no URL. Left unset when the request itself threw, which is
+     * how the tool has always billed.
+     */
+    billable?: boolean;
+};
+export declare function generateImageAsset(params: ImageAssetParams, deps: GenerateDeps): Promise<ImageAssetResult>;
+//# sourceMappingURL=image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/generators/image.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;EAexB,CAAC;AAEZ;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAQF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAsE3B"}

package/dist/generators/image.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { fetchContentLength } from '../http.js';
+import { formatZodIssues } from '../validation.js';
+export const imageAssetParamsSchema = z.object({
+    name: z.string()
+        .min(1)
+        .regex(/^[a-zA-Z][a-zA-Z0-9_]*$/, 'Name must start with letter, contain only letters, numbers, underscores')
+        .describe('Unique asset name'),
+    prompt: z.string().min(1).describe('Text description of the image to generate'),
+    width: z.number().int().positive().default(512).describe('Image width in pixels'),
+    height: z.number().int().positive().default(512).describe('Image height in pixels'),
+    referenceImageUrl: z.string().optional()
+        .describe('Style/composition reference forwarded to the image model'),
+    assetId: z.string().min(1).optional()
+        .describe('Pre-generated asset id; minted when absent'),
+}).strict();
+const ENDPOINT = '/ai/v1/generate-image-as-webp-url';
+export async function generateImageAsset(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = imageAssetParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[image] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    if (!forger.hasCredentials()) {
+        logger.error('[image] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    onProgress(`Generating image asset: ${input.name}`);
+    logger.info(`[image] Starting generation for "${input.name}"`);
+    let response;
+    try {
+        response = await forger.post(ENDPOINT, {
+            prompt: input.prompt,
+            height: input.height,
+            width: input.width,
+            numImages: 1,
+            guidanceScale: 1.0,
+            ...(input.referenceImageUrl ? { referenceImageUrl: input.referenceImageUrl } : {}),
+        }, 'image');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        logger.error({ err: error }, '[image] Error during generation');
+        return fail(message);
+    }
+    // The Forger answered, so this call bills from here on even if it carried no URL.
+    const imageUrl = response.imageUrl;
+    if (!imageUrl) {
+        return { ...fail('Asset Forger returned no image URL'), billable: true };
+    }
+    logger.info(`[image] Generated ${imageUrl}`);
+    // Asset Forger returns only a URL, so probe the stored file for its byte size
+    // (best-effort). Keeps the Assets catalog size column accurate.
+    const size = await fetchContentLength(imageUrl, logger);
+    const assetId = input.assetId ?? `img-${input.name}-${Date.now()}`;
+    const asset = {
+        id: assetId,
+        name: input.name,
+        url: imageUrl,
+        // The Assets-tab thumbnail is driven by `screenshotUrl`; for an image asset
+        // the thumbnail is the image itself. Without this, AI-generated images show
+        // a "No Preview" placeholder while uploaded ones get a thumbnail.
+        screenshotUrl: imageUrl,
+        type: 'image',
+        source: 'generated',
+        prompt: input.prompt,
+        ...(size !== undefined ? { size } : {}),
+    };
+    return ok(`Image asset "${input.name}" generated: ${imageUrl}`, [{ type: 'upsertRoot', path: ['assets'], matchKeys: ['name', 'type'], value: asset }], { assetId, name: input.name, url: imageUrl, billable: true });
+}
+//# sourceMappingURL=image.js.map

package/dist/generators/image.js.map

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

package/dist/generators/skybox.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+export declare const skyboxParamsSchema: z.ZodObject<{
+    description: z.ZodString;
+    referenceImageUrl: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    description: string;
+    referenceImageUrl?: string | undefined;
+}, {
+    description: string;
+    referenceImageUrl?: string | undefined;
+}>;
+export type SkyboxParams = z.input<typeof skyboxParamsSchema>;
+export type SkyboxResult = AssetResultBase & {
+    url?: string;
+};
+export declare function generateSkybox(params: SkyboxParams, deps: GenerateDeps): Promise<SkyboxResult>;
+//# sourceMappingURL=skybox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skybox.d.ts","sourceRoot":"","sources":["../../src/generators/skybox.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIjE,eAAO,MAAM,kBAAkB;;;;;;;;;EAIpB,CAAC;AAEZ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,MAAM,MAAM,YAAY,GAAG,eAAe,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAoB9D,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,YAAY,CAAC,CAiDvB"}

package/dist/generators/skybox.js

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { formatZodIssues } from '../validation.js';
+export const skyboxParamsSchema = z.object({
+    description: z.string().min(1).describe('Description of the skybox environment'),
+    referenceImageUrl: z.string().optional()
+        .describe('Style/composition reference forwarded to the image model'),
+}).strict();
+const SKYBOX_WIDTH = 2048;
+const SKYBOX_HEIGHT = 1024;
+const ENDPOINT = '/ai/v1/generate-image-as-webp-url';
+function buildPrompt(environmentDescription) {
+    return `Create a perfectly seamless 360-degree equirectangular panoramic skybox with matching left and right edges for a stylized low-poly scene.
+The scene description is: ${environmentDescription}.
+CRITICAL: The left and right edges of the image MUST match perfectly to ensure seamless wrapping when viewed in 360 degrees in a Unity 3D game.
+Ensure consistent lighting and color palette across the entire panorama.
+Position all landmark elements and important features higher in the frame, above the horizon line, not clustered at the bottom of the image.
+Design the image with horizontal symmetry and continuity to guarantee there is no visible seam when the edges connect.
+The entire aesthetic should maintain clear edges and minimal texturing, matching low-poly game art while creating the impression that the viewer is looking outward from a floating platform within the skyline.`;
+}
+export async function generateSkybox(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = skyboxParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[skybox] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    if (!forger.hasCredentials()) {
+        logger.error('[skybox] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    onProgress(`Generating skybox: ${input.description}`);
+    logger.info(`[skybox] Starting generation for: "${input.description}"${input.referenceImageUrl ? ' (with reference image)' : ''}`);
+    try {
+        const response = await forger.post(ENDPOINT, {
+            prompt: buildPrompt(input.description),
+            height: SKYBOX_HEIGHT,
+            width: SKYBOX_WIDTH,
+            numImages: 1,
+            guidanceScale: 1.0,
+            ...(input.referenceImageUrl ? { referenceImageUrl: input.referenceImageUrl } : {}),
+        }, 'skybox');
+        const url = response.imageUrl;
+        if (!url) {
+            throw new Error('No image URL found in API response');
+        }
+        logger.info(`[skybox] Successfully generated skybox image URL: ${url}`);
+        return ok(`Skybox image generated: ${url}`, [{ type: 'set', path: ['skyboxUrl'], value: url }], { url });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        logger.error({ err: error }, '[skybox] Error during skybox generation');
+        return fail(message);
+    }
+}
+//# sourceMappingURL=skybox.js.map

package/dist/generators/skybox.js.map

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

package/dist/generators/sound-effect.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+export declare const soundEffectParamsSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    durationSeconds: z.ZodOptional<z.ZodNumber>;
+    promptInfluence: z.ZodOptional<z.ZodNumber>;
+    loop: z.ZodOptional<z.ZodBoolean>;
+    assetId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    durationSeconds?: number | undefined;
+    promptInfluence?: number | undefined;
+    loop?: boolean | undefined;
+    assetId?: string | undefined;
+}, {
+    prompt: string;
+    durationSeconds?: number | undefined;
+    promptInfluence?: number | undefined;
+    loop?: boolean | undefined;
+    assetId?: string | undefined;
+}>;
+export type SoundEffectParams = z.input<typeof soundEffectParamsSchema>;
+export type SoundEffectResult = AssetResultBase & {
+    soundEffectUrl?: string;
+    originalUrl?: string;
+    soundId?: string;
+    format?: string;
+    sizeBytes?: number;
+};
+export declare function generateSoundEffect(params: SoundEffectParams, deps: GenerateDeps): Promise<SoundEffectResult>;
+//# sourceMappingURL=sound-effect.d.ts.map

package/dist/generators/sound-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound-effect.d.ts","sourceRoot":"","sources":["../../src/generators/sound-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKjE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;EASzB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAWF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,iBAAiB,EACzB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,iBAAiB,CAAC,CAiE5B"}

package/dist/generators/sound-effect.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { fetchContentLength } from '../http.js';
+import { formatZodIssues } from '../validation.js';
+export const soundEffectParamsSchema = z.object({
+    prompt: z.string().min(1).describe('Text describing the SFX to generate'),
+    durationSeconds: z.number().min(0.5).max(22).optional()
+        .describe('Length in seconds; upstream auto-picks when omitted'),
+    promptInfluence: z.number().min(0).max(1).optional()
+        .describe('How tightly to follow the prompt'),
+    loop: z.boolean().optional().describe('Ask upstream for a seamlessly loopable SFX'),
+    assetId: z.string().min(1).optional()
+        .describe('Pre-generated asset id; the generator id is used when absent'),
+}).strict();
+const ENDPOINT = '/ai/v1/generate-sound-effect-as-opus-url';
+export async function generateSoundEffect(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = soundEffectParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[sound-effect] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    if (!forger.hasCredentials()) {
+        logger.error('[sound-effect] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    onProgress(`Generating sound effect: ${input.prompt}`);
+    logger.info(`[sound-effect] Starting generation for: "${input.prompt}"`);
+    const payload = { prompt: input.prompt };
+    if (input.durationSeconds !== undefined)
+        payload.durationSeconds = input.durationSeconds;
+    if (input.promptInfluence !== undefined)
+        payload.promptInfluence = input.promptInfluence;
+    if (input.loop !== undefined)
+        payload.loop = input.loop;
+    try {
+        const response = await forger.post(ENDPOINT, payload, 'sound-effect');
+        if (!response.soundEffectUrl) {
+            throw new Error('No soundEffectUrl in API response');
+        }
+        logger.info(`[sound-effect] Successfully generated: ${response.soundEffectUrl}`);
+        const sizeBytes = await fetchContentLength(response.soundEffectUrl, logger);
+        const assetId = input.assetId ?? response.soundId;
+        return ok(`Sound effect generated: ${response.soundEffectUrl}`, [{
+                type: 'pushRoot',
+                path: ['assets'],
+                value: {
+                    id: assetId,
+                    name: input.prompt,
+                    url: response.soundEffectUrl,
+                    type: 'audio',
+                    format: response.format,
+                    prompt: input.prompt,
+                    source: 'generated',
+                    size: sizeBytes ?? 0,
+                    ...(input.loop !== undefined && { loop: input.loop }),
+                },
+            }], {
+            soundEffectUrl: response.soundEffectUrl,
+            originalUrl: response.originalUrl,
+            soundId: assetId,
+            format: response.format,
+            sizeBytes,
+        });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        logger.error({ err: error }, '[sound-effect] Error during generation');
+        return fail(message);
+    }
+}
+//# sourceMappingURL=sound-effect.js.map

package/dist/generators/sound-effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound-effect.js","sourceRoot":"","sources":["../../src/generators/sound-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,qCAAqC,CAAC;IACzE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;SACpD,QAAQ,CAAC,qDAAqD,CAAC;IAClE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SACjD,QAAQ,CAAC,kCAAkC,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACnF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAClC,QAAQ,CAAC,8DAA8D,CAAC;CAC5E,CAAC,CAAC,MAAM,EAAE,CAAC;AAmBZ,MAAM,QAAQ,GAAG,0CAA0C,CAAC;AAE5D,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAyB,EACzB,IAAkB;IAElB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE5C,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,EAAE,mCAAmC,CAAC,CAAC;QACxE,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,iDAAiD,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC,MAAM,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,UAAU,CAAC,4BAA4B,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,CAAC,4CAA4C,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAEzE,MAAM,OAAO,GAA4B,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;IAClE,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IACzF,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC;IACzF,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAA4B,QAAQ,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QAEjG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,0CAA0C,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;QAEjF,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC;QAElD,OAAO,EAAE,CACP,2BAA2B,QAAQ,CAAC,cAAc,EAAE,EACpD,CAAC;gBACC,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,CAAC,QAAQ,CAAC;gBAChB,KAAK,EAAE;oBACL,EAAE,EAAE,OAAO;oBACX,IAAI,EAAE,KAAK,CAAC,MAAM;oBAClB,GAAG,EAAE,QAAQ,CAAC,cAAc;oBAC5B,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,MAAM,EAAE,KAAK,CAAC,MAAM;oBACpB,MAAM,EAAE,WAAW;oBACnB,IAAI,EAAE,SAAS,IAAI,CAAC;oBACpB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;iBACtD;aACF,CAAC,EACF;YACE,cAAc,EAAE,QAAQ,CAAC,cAAc;YACvC,WAAW,EAAE,QAAQ,CAAC,WAAW;YACjC,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS;SACV,CACF,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,wBAAwB,CAAC;QAClF,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,wCAAwC,CAAC,CAAC;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,13 @@
+import type { CoreLogger } from './types.js';
+/**
+ * Probe a remote file's byte size via a HEAD request (Content-Length header).
+ * Returns undefined when the request fails or the header is missing/invalid, so
+ * callers treat the size as unknown rather than zero. Used to size
+ * backend-generated assets (image/sound) whose generator API returns only a URL
+ * — running server-side avoids the browser CORS limits on those storage hosts.
+ *
+ * The 10s abort is load-bearing: generation has no other timeout around this
+ * probe, so a hung HEAD against a storage host would stall the whole call.
+ */
+export declare function fetchContentLength(url: string, logger: CoreLogger): Promise<number | undefined>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAe7B"}

package/dist/http.js

@@ -0,0 +1,29 @@
+/**
+ * Probe a remote file's byte size via a HEAD request (Content-Length header).
+ * Returns undefined when the request fails or the header is missing/invalid, so
+ * callers treat the size as unknown rather than zero. Used to size
+ * backend-generated assets (image/sound) whose generator API returns only a URL
+ * — running server-side avoids the browser CORS limits on those storage hosts.
+ *
+ * The 10s abort is load-bearing: generation has no other timeout around this
+ * probe, so a hung HEAD against a storage host would stall the whole call.
+ */
+export async function fetchContentLength(url, logger) {
+    try {
+        const response = await fetch(url, { method: 'HEAD', signal: AbortSignal.timeout(10000) });
+        if (!response.ok) {
+            logger.warn(`HEAD ${url} returned ${response.status}`);
+            return undefined;
+        }
+        const contentLength = response.headers.get('content-length');
+        if (!contentLength)
+            return undefined;
+        const bytes = parseInt(contentLength, 10);
+        return Number.isFinite(bytes) && bytes > 0 ? bytes : undefined;
+    }
+    catch (err) {
+        logger.warn({ err }, `HEAD request failed for ${url}`);
+        return undefined;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,MAAkB;IAElB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAM,CAAC,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC,QAAQ,GAAG,aAAa,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YACvD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC7D,IAAI,CAAC,aAAa;YAAE,OAAO,SAAS,CAAC;QACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,2BAA2B,GAAG,EAAE,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export type { AssetResultBase, CoreLogger, DataWorldPatch, ForgerClient, GenerateDeps, UpsertRootPatch, WorldPatch, } from './types.js';
+export { buildUpsertPredicate, isUpsertRootPatch, validateWorldPatch } from './world-patch.js';
+export { fail, ok } from './result.js';
+export { AssetForgerClient } from './forger-client.js';
+export type { AssetForgerCredentials } from './forger-client.js';
+export { generateSkybox, skyboxParamsSchema } from './generators/skybox.js';
+export type { SkyboxParams, SkyboxResult } from './generators/skybox.js';
+export { generateSoundEffect, soundEffectParamsSchema } from './generators/sound-effect.js';
+export type { SoundEffectParams, SoundEffectResult } from './generators/sound-effect.js';
+export { generateImageAsset, imageAssetParamsSchema } from './generators/image.js';
+export type { ImageAssetParams, ImageAssetResult } from './generators/image.js';
+export { generateCharacter, characterParamsSchema } from './generators/character.js';
+export type { CharacterParams, CharacterResult } from './generators/character.js';
+export { generateAnimationAsset, animationParamsSchema, getConfiguredAnimationModel, ANIMATION_MODEL_TEXT_TO_MOTION_3, ANIMATION_MODEL_TEXT_TO_MOTION_2, ANIMATION_MODEL_OLDER, } from './generators/animation.js';
+export type { AnimationParams, AnimationResult } from './generators/animation.js';
+export { fetchContentLength } from './http.js';
+export { TERMINAL_FAILURE_CODES, TERMINAL_FAILURE_VERSION, buildTerminalFailure, isTerminalFailureCode, legacyErrorTypeFor, parseTerminalFailure, } from './terminal-failure.js';
+export type { BuildTerminalFailureInput, LegacyErrorType, TerminalFailure, TerminalFailureCode, TerminalFailureDetail, } from './terminal-failure.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,UAAU,GACX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AACrF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAM/C,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,yBAAyB,EACzB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,qBAAqB,GACtB,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { buildUpsertPredicate, isUpsertRootPatch, validateWorldPatch } from './world-patch.js';
+export { fail, ok } from './result.js';
+export { AssetForgerClient } from './forger-client.js';
+export { generateSkybox, skyboxParamsSchema } from './generators/skybox.js';
+export { generateSoundEffect, soundEffectParamsSchema } from './generators/sound-effect.js';
+export { generateImageAsset, imageAssetParamsSchema } from './generators/image.js';
+export { generateCharacter, characterParamsSchema } from './generators/character.js';
+export { generateAnimationAsset, animationParamsSchema, getConfiguredAnimationModel, ANIMATION_MODEL_TEXT_TO_MOTION_3, ANIMATION_MODEL_TEXT_TO_MOTION_2, ANIMATION_MODEL_OLDER, } from './generators/animation.js';
+export { fetchContentLength } from './http.js';
+// The agent↔client terminal-failure contract. Also published as the
+// `@bitmagic/asset-core/terminal-failure` subpath: this barrel eagerly pulls in
+// the generators (and therefore zod, the forger client, and node http helpers),
+// so browser consumers must import the subpath instead of the root.
+export { TERMINAL_FAILURE_CODES, TERMINAL_FAILURE_VERSION, buildTerminalFailure, isTerminalFailureCode, legacyErrorTypeFor, parseTerminalFailure, } from './terminal-failure.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5F,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAErF,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,2BAA2B,EAC3B,gCAAgC,EAChC,gCAAgC,EAChC,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,oEAAoE;AACpE,gFAAgF;AAChF,gFAAgF;AAChF,oEAAoE;AACpE,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}

package/dist/result.d.ts

@@ -0,0 +1,6 @@
+import type { AssetResultBase, WorldPatch } from './types.js';
+/** An unsuccessful result. Failures never carry world.json changes. */
+export declare function fail(message: string): AssetResultBase;
+/** A successful result, merging generator-specific fields onto the base shape. */
+export declare function ok<T extends object = Record<string, never>>(message: string, patches: WorldPatch[], extra?: T): AssetResultBase & T;
+//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9D,uEAAuE;AACvE,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAErD;AAED,kFAAkF;AAClF,wBAAgB,EAAE,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EACzD,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,CAAC,EAAE,CAAC,GACR,eAAe,GAAG,CAAC,CAErB"}

package/dist/result.js

@@ -0,0 +1,9 @@
+/** An unsuccessful result. Failures never carry world.json changes. */
+export function fail(message) {
+    return { success: false, message, patches: [] };
+}
+/** A successful result, merging generator-specific fields onto the base shape. */
+export function ok(message, patches, extra) {
+    return { success: true, message, patches, ...(extra ?? {}) };
+}
+//# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,MAAM,UAAU,IAAI,CAAC,OAAe;IAClC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAClD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,EAAE,CAChB,OAAe,EACf,OAAqB,EACrB,KAAS;IAET,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,IAAK,EAAQ,CAAC,EAAE,CAAC;AACtE,CAAC"}