@bitmagic/asset-core 0.2.7-dev.1 → 0.2.7-dev.11

package/dist/generators/background.d.ts

@@ -0,0 +1,37 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+/**
+ * A 2D backdrop for side-scrolling and top-down games.
+ *
+ * ── Why this is a sibling of `skybox` and not a flag on it ───────────────────────────────────
+ *
+ * Both call the same image endpoint at the same 2048x1024 and write the same field
+ * (`worldProfileData.skyboxUrl`), so the machinery is identical. What differs is the PROMPT, and
+ * it differs completely: a skybox must wrap seamlessly around a sphere with matching left and
+ * right edges and its landmarks pushed above the horizon, while a backdrop wants layered depth and
+ * a clear ground line and is only ever seen head-on. Asking one prompt to serve both produces an
+ * image that is bad at each — a 2D scene with a visible seam, or a panorama with everything
+ * bunched at the bottom.
+ *
+ * The 2048x1024 is not incidental either: the engine maps `skyboxUrl` onto a sphere in every genre
+ * (`SkyboxMaterialHelper` builds a SphereGeometry), so a backdrop authored at any other aspect
+ * would arrive stretched. 2:1 is the equirectangular ratio, which is what makes one field able to
+ * carry both kinds of image.
+ */
+export declare const backgroundParamsSchema: 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 BackgroundParams = z.input<typeof backgroundParamsSchema>;
+export type BackgroundResult = AssetResultBase & {
+    url?: string;
+    billable?: boolean;
+};
+export declare function generateBackground(params: BackgroundParams, deps: GenerateDeps): Promise<BackgroundResult>;
+//# sourceMappingURL=background.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/generators/background.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIjE;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;EAIxB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAsBtF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,gBAAgB,EACxB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,gBAAgB,CAAC,CAmD3B"}

package/dist/generators/background.js

@@ -0,0 +1,80 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { formatZodIssues } from '../validation.js';
+/**
+ * A 2D backdrop for side-scrolling and top-down games.
+ *
+ * ── Why this is a sibling of `skybox` and not a flag on it ───────────────────────────────────
+ *
+ * Both call the same image endpoint at the same 2048x1024 and write the same field
+ * (`worldProfileData.skyboxUrl`), so the machinery is identical. What differs is the PROMPT, and
+ * it differs completely: a skybox must wrap seamlessly around a sphere with matching left and
+ * right edges and its landmarks pushed above the horizon, while a backdrop wants layered depth and
+ * a clear ground line and is only ever seen head-on. Asking one prompt to serve both produces an
+ * image that is bad at each — a 2D scene with a visible seam, or a panorama with everything
+ * bunched at the bottom.
+ *
+ * The 2048x1024 is not incidental either: the engine maps `skyboxUrl` onto a sphere in every genre
+ * (`SkyboxMaterialHelper` builds a SphereGeometry), so a backdrop authored at any other aspect
+ * would arrive stretched. 2:1 is the equirectangular ratio, which is what makes one field able to
+ * carry both kinds of image.
+ */
+export const backgroundParamsSchema = z.object({
+    description: z.string().min(1).describe('Description of the background scene to generate'),
+    referenceImageUrl: z.string().optional()
+        .describe('Style/composition reference forwarded to the image model'),
+}).strict();
+/** Same as the skybox: the engine sphere-maps this field, so 2:1 is the only ratio that fits. */
+const BACKGROUND_WIDTH = 2048;
+const BACKGROUND_HEIGHT = 1024;
+const ENDPOINT = '/ai/v1/generate-image-as-webp-url';
+/** Mirrors the agent lane's `background-image-generator`, so both lanes ask for the same picture. */
+function buildPrompt(sceneDescription) {
+    return `Create a flat 2D game background illustration for a side-scrolling or top-down 2D game.
+The scene description is: ${sceneDescription}.
+Style: stylized game art with clear shapes, vibrant colors, and good contrast between foreground and background layers.
+The image should work as a static backdrop behind 2D game objects and characters.
+Include depth through layered elements (distant mountains/buildings, mid-ground features, ground/floor).
+Ensure the image has a clear horizon or ground line.
+Do NOT include any game characters, UI elements, or text.`;
+}
+export async function generateBackground(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = backgroundParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[background] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    if (!forger.hasCredentials()) {
+        logger.error('[background] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    onProgress(`Generating background: ${input.description}`);
+    logger.info(`[background] Starting generation for: "${input.description}"${input.referenceImageUrl ? ' (with reference image)' : ''}`);
+    try {
+        const response = await forger.post(ENDPOINT, {
+            prompt: buildPrompt(input.description),
+            height: BACKGROUND_HEIGHT,
+            width: BACKGROUND_WIDTH,
+            numImages: 1,
+            guidanceScale: 1.0,
+            ...(input.referenceImageUrl ? { referenceImageUrl: input.referenceImageUrl } : {}),
+        }, 'background');
+        const url = response.imageUrl;
+        if (!url) {
+            // Billable: the Forger accepted and ran the job, and was paid for it, whatever it answered.
+            return { ...fail('Asset Forger returned no image URL'), billable: true };
+        }
+        logger.info(`[background] Successfully generated background image URL: ${url}`);
+        return ok(`Background image generated: ${url}`, 
+        // The same field a skybox writes — see the file header for why one field carries both.
+        [{ type: 'set', path: ['skyboxUrl'], value: url }], { url, billable: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        logger.error({ err: error }, '[background] Error during background generation');
+        return fail(message);
+    }
+}
+//# sourceMappingURL=background.js.map

package/dist/generators/background.js.map

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

package/dist/generators/block-type.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+/**
+ * A custom voxel block type: one tileable texture, registered under a name the rest of the game
+ * refers to (`create-voxel-asset`'s `blockType`, `groundConfig.surfaceBlockType`, building code).
+ */
+export declare const blockTypeParamsSchema: z.ZodObject<{
+    name: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    sideDescription: z.ZodOptional<z.ZodString>;
+    referenceImageUrl: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    description: string;
+    name: string;
+    referenceImageUrl?: string | undefined;
+    displayName?: string | undefined;
+    sideDescription?: string | undefined;
+}, {
+    description: string;
+    name: string;
+    referenceImageUrl?: string | undefined;
+    displayName?: string | undefined;
+    sideDescription?: string | undefined;
+}>;
+export type BlockTypeParams = z.input<typeof blockTypeParamsSchema>;
+export type BlockTypeResult = AssetResultBase & {
+    blockTypeName?: string;
+    textureUrl?: string;
+    sideTextureUrl?: string;
+    billable?: boolean;
+};
+export declare function generateBlockType(params: BlockTypeParams, deps: GenerateDeps): Promise<BlockTypeResult>;
+//# sourceMappingURL=block-type.d.ts.map

package/dist/generators/block-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-type.d.ts","sourceRoot":"","sources":["../../src/generators/block-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIjE;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;EAWvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAmDF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,eAAe,CAAC,CA4H1B"}

package/dist/generators/block-type.js

@@ -0,0 +1,164 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { formatZodIssues } from '../validation.js';
+/**
+ * A custom voxel block type: one tileable texture, registered under a name the rest of the game
+ * refers to (`create-voxel-asset`'s `blockType`, `groundConfig.surfaceBlockType`, building code).
+ */
+export const blockTypeParamsSchema = z.object({
+    name: z.string().min(1)
+        .regex(/^[a-z][a-z0-9_]*$/, 'Name must be lowercase snake_case, starting with a letter')
+        .describe('Stable block-type id, lowercase snake_case (e.g. mossy_brick)'),
+    displayName: z.string().min(1).optional()
+        .describe('Human-readable label; derived from name when omitted'),
+    description: z.string().min(5).describe('What the block texture depicts'),
+    sideDescription: z.string().min(5).optional()
+        .describe('When given, the side faces get their own texture generated from this description'),
+    referenceImageUrl: z.string().optional()
+        .describe('Style/composition reference forwarded to the image model'),
+}).strict();
+const TEXTURE_PIXELS = 256;
+const ENDPOINT = '/ai/v1/generate-image-as-webp-url';
+/**
+ * The resample target the engine stores per block, NOT the size asked of the model.
+ *
+ * `BlockRegistry` reads `spec.textureSize || 64`, so omitting this or writing `0` silently
+ * quadruples the resolution of a texture whose prompt explicitly says "displayed at 16x16".
+ * Written as a literal, matching the agent lane.
+ */
+const TEXTURE_SIZE = 16;
+/**
+ * Built-in Voxel block names and their aliases, from game-play-agent's `block-types.ts`.
+ *
+ * Duplicated rather than imported: asset-core is a leaf package that cannot depend on the agent,
+ * and this list is frozen in practice — the engine pins the built-in ids these names resolve to
+ * (`customBlockIdRange.test.ts`), so a name leaving the list would be an engine change.
+ * A custom block may not shadow one: `BlockRegistry` matches names case-insensitively and keeps
+ * the FIRST registration, so the built-in would win and the paid-for texture would vanish.
+ */
+const BUILTIN_BLOCK_NAMES = new Set([
+    'asphalt', 'dirt', 'foliage', 'grass', 'ice', 'lava', 'leaves',
+    'marble', 'road', 'rock', 'sand', 'stone', 'trunk', 'water', 'wood',
+]);
+/** Lifted from the agent lane's `block-texture-generator`, so both lanes ask for the same texture. */
+function buildPrompt(description) {
+    return `Create a seamless tileable pixel art texture for a Minecraft-style voxel game block.
+The texture should depict: ${description}.
+CRITICAL REQUIREMENTS:
+- Seamless tiling in all directions (edges must match perfectly)
+- Pixel art style with large chunky pixels, NOT photorealistic
+- Use only a few flat colors with minimal gradients
+- Simple pattern with low detail — this will be displayed at 16x16 pixels
+- Fill the entire image with the texture, no borders or margins
+- No text, labels, or watermarks
+- Flat lighting, minimal shading`;
+}
+/** `mossy_brick` -> `Mossy Brick`, matching the agent lane's derivation exactly. */
+function deriveDisplayName(name) {
+    return name.replace(/_/g, ' ').replace(/\b\w/g, (character) => character.toUpperCase());
+}
+export async function generateBlockType(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = blockTypeParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[block-type] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    // Before the credentials check, and well before any spend: a shadowed name cannot be rescued
+    // later, because the engine would keep the built-in and drop this block on load.
+    if (BUILTIN_BLOCK_NAMES.has(input.name.toLowerCase())) {
+        logger.warn(`[block-type] Refusing built-in name "${input.name}"`);
+        return fail(`Block type "${input.name}" is a built-in type and cannot be redefined. Pick a unique name.`);
+    }
+    if (!forger.hasCredentials()) {
+        logger.error('[block-type] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    const displayName = input.displayName ?? deriveDisplayName(input.name);
+    onProgress(`Generating block texture: ${input.description}`);
+    logger.info(`[block-type] Starting generation for "${input.name}": "${input.description}"${input.referenceImageUrl ? ' (with reference image)' : ''}`);
+    let textureUrl;
+    try {
+        const response = await forger.post(ENDPOINT, {
+            prompt: buildPrompt(input.description),
+            height: TEXTURE_PIXELS,
+            width: TEXTURE_PIXELS,
+            numImages: 1,
+            guidanceScale: 1.0,
+            ...(input.referenceImageUrl ? { referenceImageUrl: input.referenceImageUrl } : {}),
+        }, 'block-type');
+        if (!response.imageUrl) {
+            // Billable: the Forger ran the job and was paid for it, whatever it answered.
+            return { ...fail('Asset Forger returned no block texture URL'), billable: true };
+        }
+        textureUrl = response.imageUrl;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        logger.error({ err: error }, '[block-type] Error during block texture generation');
+        return fail(message);
+    }
+    // The side texture is a bonus, not a precondition: a failure here leaves a perfectly usable
+    // block whose top texture covers every face, which is what the agent lane does too. Turning it
+    // into a hard failure would throw away a texture the creator has already paid for.
+    // No reference image on this call — the side faces follow `sideDescription` alone.
+    let sideTextureUrl = null;
+    if (input.sideDescription !== undefined) {
+        onProgress(`Generating side texture: ${input.sideDescription}`);
+        try {
+            const sideResponse = await forger.post(ENDPOINT, {
+                prompt: buildPrompt(input.sideDescription),
+                height: TEXTURE_PIXELS,
+                width: TEXTURE_PIXELS,
+                numImages: 1,
+                guidanceScale: 1.0,
+            }, 'block-type');
+            if (sideResponse.imageUrl) {
+                sideTextureUrl = sideResponse.imageUrl;
+            }
+            else {
+                logger.warn(`[block-type] Side texture came back empty for "${input.name}"; using the top texture on all faces`);
+            }
+        }
+        catch (error) {
+            logger.warn({ err: error }, `[block-type] Side texture generation failed for "${input.name}"; using the top texture on all faces`);
+        }
+    }
+    logger.info(`[block-type] Registered "${input.name}" with texture ${textureUrl}`);
+    return ok(`Block type "${input.name}" generated: ${textureUrl}`, [{
+            // `upsertRoot` with a two-segment path, NOT the `push` the agent lane uses.
+            //
+            // The agent tool can afford `push` because it reads the game's world.json first and returns
+            // early when the name is already there. This generator runs on the SERVER and cannot see the
+            // creator's local file, so a `push` would append a second entry with the same name — and
+            // `BlockRegistry` keeps the FIRST case-insensitive match and discards the rest, silently
+            // throwing away the texture just paid for. Upserting on `name` makes a re-run REPLACE, which
+            // is also what makes "regenerate this block until I like it" work.
+            //
+            // Two segments rather than a `worldProfileData`-scoped `upsert` kind: `WorldPatch` is
+            // published and already installed out in the world, and an older CLI receiving an unknown
+            // patch type falls through to writing `value` at the document ROOT — clobbering the array
+            // with a single object, without an error. `upsertRoot` is understood by every applier that
+            // exists, and both walk the two segments correctly.
+            type: 'upsertRoot',
+            path: ['worldProfileData', 'customBlockTypes'],
+            matchKeys: ['name'],
+            value: {
+                name: input.name,
+                displayName,
+                description: input.description,
+                textureUrl,
+                // null, not undefined: it survives JSON and reads as "top texture on every face".
+                sideTextureUrl,
+                textureSize: TEXTURE_SIZE,
+                createdAt: new Date().toISOString(),
+            },
+        }], {
+        blockTypeName: input.name,
+        textureUrl,
+        ...(sideTextureUrl ? { sideTextureUrl } : {}),
+        billable: true,
+    });
+}
+//# sourceMappingURL=block-type.js.map

package/dist/generators/block-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-type.js","sourceRoot":"","sources":["../../src/generators/block-type.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;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;SACpB,KAAK,CAAC,mBAAmB,EAAE,2DAA2D,CAAC;SACvF,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SACtC,QAAQ,CAAC,sDAAsD,CAAC;IACnE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IACzE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;SAC1C,QAAQ,CAAC,kFAAkF,CAAC;IAC/F,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACrC,QAAQ,CAAC,0DAA0D,CAAC;CACxE,CAAC,CAAC,MAAM,EAAE,CAAC;AAeZ,MAAM,cAAc,GAAG,GAAG,CAAC;AAC3B,MAAM,QAAQ,GAAG,mCAAmC,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,YAAY,GAAG,EAAE,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IACvD,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ;IAC9D,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM;CACpE,CAAC,CAAC;AAEH,sGAAsG;AACtG,SAAS,WAAW,CAAC,WAAmB;IACtC,OAAO;6BACoB,WAAW;;;;;;;;iCAQP,CAAC;AAClC,CAAC;AAED,oFAAoF;AACpF,SAAS,iBAAiB,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,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,iCAAiC,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7C,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;IAE1B,6FAA6F;IAC7F,iFAAiF;IACjF,IAAI,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,wCAAwC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;QACnE,OAAO,IAAI,CACT,eAAe,KAAK,CAAC,IAAI,mEAAmE,CAC7F,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QAC7B,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,4BAA4B,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEvE,UAAU,CAAC,6BAA6B,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7D,MAAM,CAAC,IAAI,CAAC,yCAAyC,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEvJ,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAChC,QAAQ,EACR;YACE,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;YACtC,MAAM,EAAE,cAAc;YACtB,KAAK,EAAE,cAAc;YACrB,SAAS,EAAE,CAAC;YACZ,aAAa,EAAE,GAAG;YAClB,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnF,EACD,YAAY,CACb,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACvB,8EAA8E;YAC9E,OAAO,EAAE,GAAG,IAAI,CAAC,4CAA4C,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACnF,CAAC;QACD,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC;IACjC,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,oDAAoD,CAAC,CAAC;QACnF,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC;IAED,4FAA4F;IAC5F,+FAA+F;IAC/F,mFAAmF;IACnF,mFAAmF;IACnF,IAAI,cAAc,GAAkB,IAAI,CAAC;IACzC,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QACxC,UAAU,CAAC,4BAA4B,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,IAAI,CACpC,QAAQ,EACR;gBACE,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,eAAe,CAAC;gBAC1C,MAAM,EAAE,cAAc;gBACtB,KAAK,EAAE,cAAc;gBACrB,SAAS,EAAE,CAAC;gBACZ,aAAa,EAAE,GAAG;aACnB,EACD,YAAY,CACb,CAAC;YACF,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;gBAC1B,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,kDAAkD,KAAK,CAAC,IAAI,uCAAuC,CAAC,CAAC;YACnH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,oDAAoD,KAAK,CAAC,IAAI,uCAAuC,CAAC,CAAC;QACrI,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,4BAA4B,KAAK,CAAC,IAAI,kBAAkB,UAAU,EAAE,CAAC,CAAC;IAElF,OAAO,EAAE,CACP,eAAe,KAAK,CAAC,IAAI,gBAAgB,UAAU,EAAE,EACrD,CAAC;YACC,4EAA4E;YAC5E,EAAE;YACF,4FAA4F;YAC5F,6FAA6F;YAC7F,yFAAyF;YACzF,yFAAyF;YACzF,6FAA6F;YAC7F,mEAAmE;YACnE,EAAE;YACF,sFAAsF;YACtF,0FAA0F;YAC1F,0FAA0F;YAC1F,2FAA2F;YAC3F,oDAAoD;YACpD,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;YAC9C,SAAS,EAAE,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,WAAW;gBACX,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,UAAU;gBACV,kFAAkF;gBAClF,cAAc;gBACd,WAAW,EAAE,YAAY;gBACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC,EACF;QACE,aAAa,EAAE,KAAK,CAAC,IAAI;QACzB,UAAU;QACV,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7C,QAAQ,EAAE,IAAI;KACf,CACF,CAAC;AACJ,CAAC"}

package/dist/generators/character.d.ts

@@ -7,14 +7,14 @@ export declare const characterParamsSchema: z.ZodObject<{
     headScale: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     assetId: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    prompt: string;
     name: string;
+    prompt: string;
     applyToPlayer: boolean;
     headScale: number;
     assetId?: string | undefined;
 }, {
-    prompt: string;
     name: string;
+    prompt: string;
     assetId?: string | undefined;
     applyToPlayer?: boolean | undefined;
     headScale?: number | undefined;

package/dist/generators/image.d.ts

@@ -8,15 +8,15 @@ export declare const imageAssetParamsSchema: z.ZodObject<{
     referenceImageUrl: z.ZodOptional<z.ZodString>;
     assetId: z.ZodOptional<z.ZodString>;
 }, "strict", z.ZodTypeAny, {
-    prompt: string;
     name: string;
+    prompt: string;
     width: number;
     height: number;
     referenceImageUrl?: string | undefined;
     assetId?: string | undefined;
 }, {
-    prompt: string;
     name: string;
+    prompt: string;
     referenceImageUrl?: string | undefined;
     assetId?: string | undefined;
     width?: number | undefined;

package/dist/generators/prop-voxel.d.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod';
+import type { AssetResultBase, GenerateDeps } from '../types.js';
+/**
+ * A 3D prop as VOXELS, from a prompt — with no mesh in between.
+ *
+ * The sibling of `prop.ts`, and the same shape: it returns no world.json patches, because a
+ * generated thing is only half an asset until the engine has baked it, and baking happens in a
+ * browser on the caller's side of the seam. What differs is what the Forger is asked for.
+ *
+ * `prop.ts` asks for a GLB. For a voxel asset that mesh is discarded work: TRELLIS.2 is already a
+ * sparse voxel generator internally, and the polygon mesh is produced afterwards by a decimation,
+ * remesh and PBR bake that a voxelizer immediately throws away. `/ai/v1/forge-voxels` taps the
+ * voxel field directly, so what comes back is a sub-megabyte HFVX master rather than a 50-100 MB
+ * textured mesh. Measured on staging: 219 KB and ~8.5s warm, against minutes and megabytes.
+ *
+ * The host bakes the master with `CREATE_ASSET_FROM_VXL_MASTER` instead of
+ * `CREATE_ASSET_FROM_GLB_URL`; both are answered on the same reply channel, so only the request
+ * differs. `game-play-agent/src/mastra/utils/hq-asset-jobs.ts` already picks between those two
+ * shapes — the web lane's HQ job takes this same fork when a local forge produced a master.
+ *
+ * Billable on acceptance, exactly as `prop.ts` is: the vendor charges for the job it ran, whatever
+ * it answered with.
+ */
+/**
+ * Grids the master packer accepts, and why this is an allowlist rather than a positive integer.
+ *
+ * The packer maps native coordinates into the target grid by integer division, so a grid that does
+ * not divide the native resolution pushes the top coordinate past the grid — and reports that as
+ * "axis mapping is wrong", which sends the reader hunting somewhere nothing is wrong. asset-forger
+ * validates this too; validating here as well keeps a bad request from costing a GPU minute.
+ *
+ * 0 means "keep TRELLIS's own resolution" — the master every later re-voxelization downsamples
+ * from, rather than a working asset.
+ */
+export declare const propVoxelGrids: readonly [0, 32, 64, 128, 256, 512];
+export declare const propVoxelParamsSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    /**
+     * 128 matches what the web lane has always produced voxel assets at. A project should not get a
+     * different-looking asset depending on which lane asked for it.
+     */
+    grid: z.ZodDefault<z.ZodOptional<z.ZodUnion<[z.ZodLiteral<0>, z.ZodLiteral<32>, z.ZodLiteral<64>, z.ZodLiteral<128>, z.ZodLiteral<256>, z.ZodLiteral<512>]>>>;
+}, "strict", z.ZodTypeAny, {
+    prompt: string;
+    grid: 0 | 64 | 32 | 256 | 512 | 128;
+}, {
+    prompt: string;
+    grid?: 0 | 64 | 32 | 256 | 512 | 128 | undefined;
+}>;
+export type PropVoxelParams = z.input<typeof propVoxelParamsSchema>;
+export type PropVoxelResult = AssetResultBase & {
+    /** Where the HFVX voxel master landed. The host bakes this into a `.vxl`. */
+    masterUrl?: string;
+    /** TRELLIS's own resolution, which the master was downsampled from. */
+    resolution?: number;
+    voxelCount?: number;
+    billable?: boolean;
+};
+export declare function generatePropVoxels(params: PropVoxelParams, deps: GenerateDeps): Promise<PropVoxelResult>;
+//# sourceMappingURL=prop-voxel.d.ts.map

package/dist/generators/prop-voxel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prop-voxel.d.ts","sourceRoot":"","sources":["../../src/generators/prop-voxel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIjE;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAElE,eAAO,MAAM,qBAAqB;;IAIhC;;;OAGG;;;;;;;;EAKM,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAC9C,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAiBF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,eAAe,CAAC,CAoD1B"}

package/dist/generators/prop-voxel.js

@@ -0,0 +1,97 @@
+import { z } from 'zod';
+import { fail, ok } from '../result.js';
+import { formatZodIssues } from '../validation.js';
+/**
+ * A 3D prop as VOXELS, from a prompt — with no mesh in between.
+ *
+ * The sibling of `prop.ts`, and the same shape: it returns no world.json patches, because a
+ * generated thing is only half an asset until the engine has baked it, and baking happens in a
+ * browser on the caller's side of the seam. What differs is what the Forger is asked for.
+ *
+ * `prop.ts` asks for a GLB. For a voxel asset that mesh is discarded work: TRELLIS.2 is already a
+ * sparse voxel generator internally, and the polygon mesh is produced afterwards by a decimation,
+ * remesh and PBR bake that a voxelizer immediately throws away. `/ai/v1/forge-voxels` taps the
+ * voxel field directly, so what comes back is a sub-megabyte HFVX master rather than a 50-100 MB
+ * textured mesh. Measured on staging: 219 KB and ~8.5s warm, against minutes and megabytes.
+ *
+ * The host bakes the master with `CREATE_ASSET_FROM_VXL_MASTER` instead of
+ * `CREATE_ASSET_FROM_GLB_URL`; both are answered on the same reply channel, so only the request
+ * differs. `game-play-agent/src/mastra/utils/hq-asset-jobs.ts` already picks between those two
+ * shapes — the web lane's HQ job takes this same fork when a local forge produced a master.
+ *
+ * Billable on acceptance, exactly as `prop.ts` is: the vendor charges for the job it ran, whatever
+ * it answered with.
+ */
+/**
+ * Grids the master packer accepts, and why this is an allowlist rather than a positive integer.
+ *
+ * The packer maps native coordinates into the target grid by integer division, so a grid that does
+ * not divide the native resolution pushes the top coordinate past the grid — and reports that as
+ * "axis mapping is wrong", which sends the reader hunting somewhere nothing is wrong. asset-forger
+ * validates this too; validating here as well keeps a bad request from costing a GPU minute.
+ *
+ * 0 means "keep TRELLIS's own resolution" — the master every later re-voxelization downsamples
+ * from, rather than a working asset.
+ */
+export const propVoxelGrids = [0, 32, 64, 128, 256, 512];
+export const propVoxelParamsSchema = z.object({
+    prompt: z.string()
+        .min(1)
+        .describe('What the object should be (e.g. "a weathered stone archway covered in moss")'),
+    /**
+     * 128 matches what the web lane has always produced voxel assets at. A project should not get a
+     * different-looking asset depending on which lane asked for it.
+     */
+    grid: z.union([
+        z.literal(0), z.literal(32), z.literal(64),
+        z.literal(128), z.literal(256), z.literal(512),
+    ]).optional().default(128),
+}).strict();
+/**
+ * The async job route, not the synchronous one. A cold GPU container compiles CUDA kernels and
+ * loads a 4B model before it can generate, so a first request runs to minutes — well past what a
+ * single HTTP request should hold open.
+ */
+const ENDPOINT = '/ai/v1/forge-voxels/jobs';
+export async function generatePropVoxels(params, deps) {
+    const { forger, logger, onProgress } = deps;
+    const parsed = propVoxelParamsSchema.safeParse(params);
+    if (!parsed.success) {
+        logger.warn({ err: parsed.error }, '[prop-voxel] Invalid parameters');
+        return fail(formatZodIssues(parsed.error));
+    }
+    const input = parsed.data;
+    if (!forger.hasCredentials()) {
+        logger.error('[prop-voxel] Missing Asset Forger credentials');
+        return fail(forger.getMissingCredentialsMessage());
+    }
+    onProgress(`Generating voxels for: ${input.prompt}`);
+    logger.info(`[prop-voxel] Starting forge-voxels for "${input.prompt}" at grid ${input.grid}`);
+    let response;
+    try {
+        response = await forger.postJobAndWait(ENDPOINT, { prompt: input.prompt, grid: input.grid }, 'prop-voxel');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error occurred';
+        logger.error({ err: error }, '[prop-voxel] Error during generation');
+        return fail(message);
+    }
+    const masterUrl = response.data?.masterUrl;
+    if (!masterUrl) {
+        // Billable: the Forger accepted and ran the job, and was paid for it, whatever it answered.
+        return { ...fail('Asset Forger returned no master URL for the generated voxels'), billable: true };
+    }
+    const { resolution, voxelCount } = response.data ?? {};
+    logger.info(`[prop-voxel] Generated ${masterUrl} (${voxelCount ?? '?'} voxels)`);
+    return ok(`Voxels generated: ${masterUrl}`, 
+    // Deliberately empty — see the file header. The asset does not exist until the host has baked
+    // this master, and writing a half-made entry would leave world.json describing an asset the
+    // engine cannot load.
+    [], {
+        masterUrl,
+        ...(resolution === undefined ? {} : { resolution }),
+        ...(voxelCount === undefined ? {} : { voxelCount }),
+        billable: true,
+    });
+}
+//# sourceMappingURL=prop-voxel.js.map

package/dist/generators/prop-voxel.js.map

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

package/dist/index.d.ts

@@ -5,6 +5,10 @@ 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 { generateBackground, backgroundParamsSchema } from './generators/background.js';
+export type { BackgroundParams, BackgroundResult } from './generators/background.js';
+export { generateBlockType, blockTypeParamsSchema } from './generators/block-type.js';
+export type { BlockTypeParams, BlockTypeResult } from './generators/block-type.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';
@@ -13,13 +17,15 @@ export { generateCharacter, characterParamsSchema } from './generators/character
 export type { CharacterParams, CharacterResult } from './generators/character.js';
 export { generateProp, propParamsSchema } from './generators/prop.js';
 export type { PropParams, PropResult } from './generators/prop.js';
+export { generatePropVoxels, propVoxelParamsSchema, propVoxelGrids } from './generators/prop-voxel.js';
+export type { PropVoxelParams, PropVoxelResult } from './generators/prop-voxel.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 { PIXAR_VOXEL_STYLE, MAX_COVER_DESIGN_CHARS, buildCoverArtPrompt } from './cover-prompt.js';
 export { JUDGE_DIMENSIONS, judgeScorecardSchema } from './judge-scorecard.js';
 export type { JudgeDimension, JudgeScorecard } from './judge-scorecard.js';
-export { JUDGE_GENRE_HINTS, JUDGE_RUBRIC, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, } from './judge-prompt.js';
+export { JUDGE_GENRE_HINTS, JUDGE_MOBILE_HINT, JUDGE_RUBRIC, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, } from './judge-prompt.js';
 export type { JudgeRubricInput } from './judge-prompt.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';

package/dist/index.d.ts.map

@@ -1 +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,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,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;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAM1D,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"}
+{"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,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACxF,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACtF,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACnF,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,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACtE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACvG,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AACnF,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;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAM1D,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

@@ -2,15 +2,18 @@ export { buildUpsertPredicate, isUpsertRootPatch, validateWorldPatch } from './w
 export { fail, ok } from './result.js';
 export { AssetForgerClient } from './forger-client.js';
 export { generateSkybox, skyboxParamsSchema } from './generators/skybox.js';
+export { generateBackground, backgroundParamsSchema } from './generators/background.js';
+export { generateBlockType, blockTypeParamsSchema } from './generators/block-type.js';
 export { generateSoundEffect, soundEffectParamsSchema } from './generators/sound-effect.js';
 export { generateImageAsset, imageAssetParamsSchema } from './generators/image.js';
 export { generateCharacter, characterParamsSchema } from './generators/character.js';
 export { generateProp, propParamsSchema } from './generators/prop.js';
+export { generatePropVoxels, propVoxelParamsSchema, propVoxelGrids } from './generators/prop-voxel.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';
 export { PIXAR_VOXEL_STYLE, MAX_COVER_DESIGN_CHARS, buildCoverArtPrompt } from './cover-prompt.js';
 export { JUDGE_DIMENSIONS, judgeScorecardSchema } from './judge-scorecard.js';
-export { JUDGE_GENRE_HINTS, JUDGE_RUBRIC, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, } from './judge-prompt.js';
+export { JUDGE_GENRE_HINTS, JUDGE_MOBILE_HINT, JUDGE_RUBRIC, MAX_JUDGE_DESIGN_CHARS, MAX_JUDGE_SCENE_FACTS_CHARS, MAX_JUDGE_VERIFY_CHARS, buildJudgeRubric, } from './judge-prompt.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),

package/dist/index.js.map

@@ -1 +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,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,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;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,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"}
+{"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,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEtF,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,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEtE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEvG,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;AAC/C,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,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/judge-prompt.d.ts

@@ -21,6 +21,19 @@ export declare const MAX_JUDGE_SCENE_FACTS_CHARS = 2500;
  * not gameplay.
  */
 export declare const JUDGE_RUBRIC = "Score each dimension from 1 to 10:\n\n- visual-quality: Does the frame look like a finished game? 3 = flat default\n  materials, untextured primitives, harsh unshadowed lighting. 8 = cohesive\n  palette, deliberate lighting, materials and shapes that read as one art style.\n- readability: Could a new player tell from this frame alone what to do and\n  where to go? 3 = player, goals and hazards blend into the background. 8 = the\n  player character, the route and the interactive elements pop at a glance.\n- design-fidelity: Does the frame match the game the design document describes?\n  3 = generic scene that could be any game. 8 = the described setting, mood and\n  core mechanic are recognizably on screen.\n- polish: 3 = placeholder blocks, floating or intersecting props, empty default\n  skybox, raw default HUD. 8 = grounded objects, dressed edges of the world,\n  HUD that belongs to this game.";
+/**
+ * What changes when the frame is a phone screenshot rather than a desktop one.
+ *
+ * It adds no dimension — the scorecard schema is fixed (judge-scorecard.ts) and a fifth score
+ * would not survive the wire contract. What it does is re-point the EXISTING dimensions at a
+ * screen held in a hand: `readability` becomes "can a thumb reach this and can an eye read it at
+ * this size", and `visual-quality`/`polish` become "what detail actually survives here".
+ *
+ * The last paragraph is the load-bearing one. Without it a vision model reliably reports the
+ * touch controls themselves as clutter and the missing key hints as a defect, which is exactly
+ * backwards — those controls are the mobile build working.
+ */
+export declare const JUDGE_MOBILE_HINT = "This frame is a PHONE screen, captured at the phone's own\nresolution with the game's touch controls live on top of it. Judge it as something held in one or\ntwo hands \u2014 the same dimensions, read differently:\n\n- readability: are the touch controls (joystick, action buttons) actually visible against the\n  scene, and big enough to hit with a thumb? Is the HUD legible at THIS size, not merely present?\n  Is anything the player must read or press sitting where a hand covers it, or jammed into the\n  very edge of the screen?\n- visual-quality and polish: grade the detail that survives at this resolution. Detail too small\n  to make out here is not detail the player gets.\n- Judge the framing this aspect ratio gives: does the camera show enough of the world ahead of\n  the player to actually play, or is the important part cropped away?\n\nDo not penalise missing desktop affordances \u2014 key hints, mouse or crosshair cues and hover states\nbelong to the other platform. Do not report the touch controls themselves as clutter unless they\ncover something the player needs to see.";
 /**
  * Genre-specific bullets, keyed loosely on the engine's mechanic recipe names
  * (mechanic-platformer.md and friends). Deliberately short: these steer the
@@ -33,6 +46,11 @@ export interface JudgeRubricInput {
     designText: string;
     /** Optional genre key; unknown keys are ignored. */
     genre?: string;
+    /**
+     * Which platform's frame is being judged. 'mobile' adds JUDGE_MOBILE_HINT; anything else, and
+     * absence, compose exactly the rubric that was composed before this existed.
+     */
+    platform?: 'desktop' | 'mobile';
     /** One-paragraph verify summary: run state plus a console tail. */
     verifySummary?: string;
     /**
@@ -49,5 +67,5 @@ export interface JudgeRubricInput {
  * the text part alongside the screenshot(s); the server prepends its fixed
  * judging instructions and appends the JSON output directive.
  */
-export declare function buildJudgeRubric({ designText, genre, verifySummary, sceneFacts }: JudgeRubricInput): string;
+export declare function buildJudgeRubric({ designText, genre, platform, verifySummary, sceneFacts, }: JudgeRubricInput): string;
 //# sourceMappingURL=judge-prompt.d.ts.map

package/dist/judge-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"judge-prompt.d.ts","sourceRoot":"","sources":["../src/judge-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,yDAAyD;AACzD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,i5BAaQ,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBpD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAkC3G"}
+{"version":3,"file":"judge-prompt.d.ts","sourceRoot":"","sources":["../src/judge-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,yEAAyE;AACzE,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,yDAAyD;AACzD,eAAO,MAAM,2BAA2B,OAAO,CAAC;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,YAAY,i5BAaQ,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,4kCAeW,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBpD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,UAAU,EACV,KAAK,EACL,QAAQ,EACR,aAAa,EACb,UAAU,GACX,EAAE,gBAAgB,GAAG,MAAM,CAuC3B"}

package/dist/judge-prompt.js

@@ -35,6 +35,34 @@ export const JUDGE_RUBRIC = `Score each dimension from 1 to 10:
 - polish: 3 = placeholder blocks, floating or intersecting props, empty default
   skybox, raw default HUD. 8 = grounded objects, dressed edges of the world,
   HUD that belongs to this game.`;
+/**
+ * What changes when the frame is a phone screenshot rather than a desktop one.
+ *
+ * It adds no dimension — the scorecard schema is fixed (judge-scorecard.ts) and a fifth score
+ * would not survive the wire contract. What it does is re-point the EXISTING dimensions at a
+ * screen held in a hand: `readability` becomes "can a thumb reach this and can an eye read it at
+ * this size", and `visual-quality`/`polish` become "what detail actually survives here".
+ *
+ * The last paragraph is the load-bearing one. Without it a vision model reliably reports the
+ * touch controls themselves as clutter and the missing key hints as a defect, which is exactly
+ * backwards — those controls are the mobile build working.
+ */
+export const JUDGE_MOBILE_HINT = `This frame is a PHONE screen, captured at the phone's own
+resolution with the game's touch controls live on top of it. Judge it as something held in one or
+two hands — the same dimensions, read differently:
+
+- readability: are the touch controls (joystick, action buttons) actually visible against the
+  scene, and big enough to hit with a thumb? Is the HUD legible at THIS size, not merely present?
+  Is anything the player must read or press sitting where a hand covers it, or jammed into the
+  very edge of the screen?
+- visual-quality and polish: grade the detail that survives at this resolution. Detail too small
+  to make out here is not detail the player gets.
+- Judge the framing this aspect ratio gives: does the camera show enough of the world ahead of
+  the player to actually play, or is the important part cropped away?
+
+Do not penalise missing desktop affordances — key hints, mouse or crosshair cues and hover states
+belong to the other platform. Do not report the touch controls themselves as clutter unless they
+cover something the player needs to see.`;
 /**
  * Genre-specific bullets, keyed loosely on the engine's mechanic recipe names
  * (mechanic-platformer.md and friends). Deliberately short: these steer the
@@ -61,28 +89,37 @@ export const JUDGE_GENRE_HINTS = {
 - Do buildable spots and built towers read differently?
 - Is the economy/wave HUD legible?`,
 };
+/** A section's text, trimmed and capped — empty when there is nothing to send. */
+function excerpt(text, maxChars) {
+    return text?.trim().slice(0, maxChars) ?? '';
+}
 /**
  * Compose the project-derived half of the judge prompt. The result is sent as
  * the text part alongside the screenshot(s); the server prepends its fixed
  * judging instructions and appends the JSON output directive.
  */
-export function buildJudgeRubric({ designText, genre, verifySummary, sceneFacts }) {
+export function buildJudgeRubric({ designText, genre, platform, verifySummary, sceneFacts, }) {
     const sections = [JUDGE_RUBRIC];
-    const genreHints = genre ? JUDGE_GENRE_HINTS[genre.trim().toLowerCase()] : undefined;
+    // Immediately after the rubric it modifies, and before the genre hints: a small model weights
+    // early context most, and "this is a phone" changes how every bullet above should be read.
+    if (platform === 'mobile')
+        sections.push(JUDGE_MOBILE_HINT);
+    const genreKey = genre?.trim().toLowerCase() ?? '';
+    const genreHints = JUDGE_GENRE_HINTS[genreKey];
     if (genreHints) {
-        sections.push(`Genre-specific checks (${genre.trim().toLowerCase()}):\n${genreHints}`);
+        sections.push(`Genre-specific checks (${genreKey}):\n${genreHints}`);
     }
-    const design = designText.trim().slice(0, MAX_JUDGE_DESIGN_CHARS);
+    const design = excerpt(designText, MAX_JUDGE_DESIGN_CHARS);
     sections.push(design
         ? `The game's design document (judge design-fidelity against this):\n${design}`
         : 'No design document was provided; score design-fidelity on internal coherence — does the frame look like one deliberate game rather than assorted parts?');
-    const facts = sceneFacts?.trim().slice(0, MAX_JUDGE_SCENE_FACTS_CHARS);
+    const facts = excerpt(sceneFacts, MAX_JUDGE_SCENE_FACTS_CHARS);
     if (facts) {
         sections.push('Ground truth from the engine — the frame shows ONE camera angle of this world. Trust these '
             + 'facts over anything you infer from the frame, and never report a finding they '
             + `contradict (e.g. "the world is empty" when objects exist off-camera):\n${facts}`);
     }
-    const verify = verifySummary?.trim().slice(0, MAX_JUDGE_VERIFY_CHARS);
+    const verify = excerpt(verifySummary, MAX_JUDGE_VERIFY_CHARS);
     if (verify) {
         sections.push(`Context from the automated boot check of this exact build:\n${verify}`);
     }

package/dist/judge-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"judge-prompt.js","sourceRoot":"","sources":["../src/judge-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,yEAAyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;iCAaK,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,UAAU,EAAE;;yEAE2D;IACvE,MAAM,EAAE;;8DAEoD;IAC5D,OAAO,EAAE;;sDAE2C;IACpD,MAAM,EAAE;;mDAEyC;IACjD,OAAO,EAAE;;2DAEgD;IACzD,eAAe,EAAE;;mCAEgB;CAClC,CAAC;AAmBF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAoB;IACjG,MAAM,QAAQ,GAAa,CAAC,YAAY,CAAC,CAAC;IAE1C,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrF,IAAI,UAAU,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,0BAA0B,KAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,UAAU,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAClE,QAAQ,CAAC,IAAI,CACX,MAAM;QACJ,CAAC,CAAC,qEAAqE,MAAM,EAAE;QAC/E,CAAC,CAAC,yJAAyJ,CAC9J,CAAC;IAEF,MAAM,KAAK,GAAG,UAAU,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;IACvE,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CACX,6FAA6F;cACzF,gFAAgF;cAChF,0EAA0E,KAAK,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,aAAa,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;IACtE,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC,+DAA+D,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,QAAQ,CAAC,IAAI,CACX,gMAAgM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC/N,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}
+{"version":3,"file":"judge-prompt.js","sourceRoot":"","sources":["../src/judge-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,yEAAyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,yDAAyD;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;iCAaK,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;yCAeQ,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,UAAU,EAAE;;yEAE2D;IACvE,MAAM,EAAE;;8DAEoD;IAC5D,OAAO,EAAE;;sDAE2C;IACpD,MAAM,EAAE;;mDAEyC;IACjD,OAAO,EAAE;;2DAEgD;IACzD,eAAe,EAAE;;mCAEgB;CAClC,CAAC;AAwBF,kFAAkF;AAClF,SAAS,OAAO,CAAC,IAAwB,EAAE,QAAgB;IACzD,OAAO,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,UAAU,EACV,KAAK,EACL,QAAQ,EACR,aAAa,EACb,UAAU,GACO;IACjB,MAAM,QAAQ,GAAa,CAAC,YAAY,CAAC,CAAC;IAE1C,8FAA8F;IAC9F,2FAA2F;IAC3F,IAAI,QAAQ,KAAK,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAE5D,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,UAAU,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,0BAA0B,QAAQ,OAAO,UAAU,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,CACX,MAAM;QACJ,CAAC,CAAC,qEAAqE,MAAM,EAAE;QAC/E,CAAC,CAAC,yJAAyJ,CAC9J,CAAC;IAEF,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,2BAA2B,CAAC,CAAC;IAC/D,IAAI,KAAK,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CACX,6FAA6F;cACzF,gFAAgF;cAChF,0EAA0E,KAAK,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IAC9D,IAAI,MAAM,EAAE,CAAC;QACX,QAAQ,CAAC,IAAI,CAAC,+DAA+D,MAAM,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,QAAQ,CAAC,IAAI,CACX,gMAAgM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC/N,CAAC;IAEF,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bitmagic/asset-core",
-  "version": "0.2.7-dev.1",
+  "version": "0.2.7-dev.11",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": "Bitmagic Oy",
   "type": "module",