@bitmagic/asset-core 0.2.7-dev.0 → 0.2.7-dev.10

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":"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"}

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,10 +17,16 @@ 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 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';
 //# sourceMappingURL=index.d.ts.map

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;AAMnG,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,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,13 +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';
 // 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;AAEnG,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,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

@@ -0,0 +1,53 @@
+/**
+ * Quality-judge rubric composition for `bitmagic judge`. Like cover-prompt.ts
+ * this module composes strings only — no network, no credentials — and lives
+ * here so any lane that judges a game frame grades against the same rubric.
+ *
+ * Split of responsibilities: the CLI composes everything project-derived (the
+ * design excerpt, the genre hint, the verify summary) via buildJudgeRubric;
+ * the api-server owns the fixed judge instructions and the output-schema
+ * directive, so the instructions and judgeScorecardSchema cannot drift apart.
+ */
+/** How much of GAME-DESIGN.md reaches the judge; the rest is dropped. */
+export declare const MAX_JUDGE_DESIGN_CHARS = 4000;
+/** How much verify context (run state + console tail) reaches the judge. */
+export declare const MAX_JUDGE_VERIFY_CHARS = 4000;
+/** How much engine scene inventory reaches the judge. */
+export declare const MAX_JUDGE_SCENE_FACTS_CHARS = 2500;
+/**
+ * The generic rubric: every dimension with concrete anchors for what a low and
+ * a high score look like, so two runs of a small model land near each other.
+ * Keep anchors about what is VISIBLE IN A FRAME — the judge sees screenshots,
+ * 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.";
+/**
+ * Genre-specific bullets, keyed loosely on the engine's mechanic recipe names
+ * (mechanic-platformer.md and friends). Deliberately short: these steer the
+ * judge's attention, they do not restate the recipes — the full recipes are
+ * engine implementation docs and never reach the model.
+ */
+export declare const JUDGE_GENRE_HINTS: Record<string, string>;
+export interface JudgeRubricInput {
+    /** GAME-DESIGN.md content; empty when the project has none. */
+    designText: string;
+    /** Optional genre key; unknown keys are ignored. */
+    genre?: string;
+    /** One-paragraph verify summary: run state plus a console tail. */
+    verifySummary?: string;
+    /**
+     * A deterministic inventory of the scene (object counts and spread, assets,
+     * world settings), composed in code from world.json. The frame shows one
+     * camera angle; this is the whole world — the rubric tells the judge to
+     * trust it over inference from pixels, which is what stops findings like
+     * "the world is empty" when the content is simply behind the camera.
+     */
+    sceneFacts?: string;
+}
+/**
+ * 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 declare function buildJudgeRubric({ designText, genre, verifySummary, sceneFacts }: JudgeRubricInput): string;
+//# sourceMappingURL=judge-prompt.d.ts.map

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

@@ -0,0 +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;AAOD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAmC3G"}

package/dist/judge-prompt.js

@@ -0,0 +1,97 @@
+/**
+ * Quality-judge rubric composition for `bitmagic judge`. Like cover-prompt.ts
+ * this module composes strings only — no network, no credentials — and lives
+ * here so any lane that judges a game frame grades against the same rubric.
+ *
+ * Split of responsibilities: the CLI composes everything project-derived (the
+ * design excerpt, the genre hint, the verify summary) via buildJudgeRubric;
+ * the api-server owns the fixed judge instructions and the output-schema
+ * directive, so the instructions and judgeScorecardSchema cannot drift apart.
+ */
+import { JUDGE_DIMENSIONS } from './judge-scorecard.js';
+/** How much of GAME-DESIGN.md reaches the judge; the rest is dropped. */
+export const MAX_JUDGE_DESIGN_CHARS = 4000;
+/** How much verify context (run state + console tail) reaches the judge. */
+export const MAX_JUDGE_VERIFY_CHARS = 4000;
+/** How much engine scene inventory reaches the judge. */
+export const MAX_JUDGE_SCENE_FACTS_CHARS = 2500;
+/**
+ * The generic rubric: every dimension with concrete anchors for what a low and
+ * a high score look like, so two runs of a small model land near each other.
+ * Keep anchors about what is VISIBLE IN A FRAME — the judge sees screenshots,
+ * not gameplay.
+ */
+export const JUDGE_RUBRIC = `Score each dimension from 1 to 10:
+
+- visual-quality: Does the frame look like a finished game? 3 = flat default
+  materials, untextured primitives, harsh unshadowed lighting. 8 = cohesive
+  palette, deliberate lighting, materials and shapes that read as one art style.
+- readability: Could a new player tell from this frame alone what to do and
+  where to go? 3 = player, goals and hazards blend into the background. 8 = the
+  player character, the route and the interactive elements pop at a glance.
+- design-fidelity: Does the frame match the game the design document describes?
+  3 = generic scene that could be any game. 8 = the described setting, mood and
+  core mechanic are recognizably on screen.
+- 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.`;
+/**
+ * Genre-specific bullets, keyed loosely on the engine's mechanic recipe names
+ * (mechanic-platformer.md and friends). Deliberately short: these steer the
+ * judge's attention, they do not restate the recipes — the full recipes are
+ * engine implementation docs and never reach the model.
+ */
+export const JUDGE_GENRE_HINTS = {
+    platformer: `- Is the traversal route readable — can you see where to jump next?
+- Do platforms and hazards contrast with the backdrop?
+- Does the camera frame the player with room in the direction of travel?`,
+    racing: `- Is the track boundary unmistakable at speed?
+- Do track, walls and scenery separate visually?
+- Is there a sense of direction — where the next corner goes?`,
+    shooter: `- Are potential targets visible against the environment?
+- Is there a usable crosshair/aim affordance and ammo/health HUD?
+- Does the scene offer readable cover and sightlines?`,
+    combat: `- Do combatants stand out from the arena?
+- Are health/stamina affordances present and legible?
+- Does the arena read as a bounded fighting space?`,
+    driving: `- Is the drivable surface clearly distinct from off-road?
+- Does the vehicle sit convincingly on the ground?
+- Are speed cues (road markings, scenery density) present?`,
+    'tower-defense': `- Is the creep path readable end to end?
+- 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 }) {
+    const sections = [JUDGE_RUBRIC];
+    const genreKey = genre?.trim().toLowerCase() ?? '';
+    const genreHints = JUDGE_GENRE_HINTS[genreKey];
+    if (genreHints) {
+        sections.push(`Genre-specific checks (${genreKey}):\n${genreHints}`);
+    }
+    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 = 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 = excerpt(verifySummary, MAX_JUDGE_VERIFY_CHARS);
+    if (verify) {
+        sections.push(`Context from the automated boot check of this exact build:\n${verify}`);
+    }
+    sections.push(`Findings must be specific, visible in the frame, and actionable by a developer — name the object or region and say what to change. Report at most 3, most severe first. Dimensions to score: ${JUDGE_DIMENSIONS.join(', ')}.`);
+    return sections.join('\n\n');
+}
+//# sourceMappingURL=judge-prompt.js.map

package/dist/judge-prompt.js.map

@@ -0,0 +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,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,EAAE,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAoB;IACjG,MAAM,QAAQ,GAAa,CAAC,YAAY,CAAC,CAAC;IAE1C,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/dist/judge-scorecard.d.ts

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+/**
+ * The quality-judge scorecard contract, shared by the api-server judge route
+ * (which validates what the vision model returned) and the CLI (which
+ * validates the terminal frame before writing `.bitmagic/judge.json`). It
+ * lives here so the two sides can never drift: a scorecard the server accepts
+ * is by construction one the CLI can record and render.
+ *
+ * Dimension names are a fixed enum, not free text, so scores stay comparable
+ * run over run — "readability: 4 → 7" only means something if both runs were
+ * grading the same axis.
+ */
+export declare const JUDGE_DIMENSIONS: readonly ["visual-quality", "readability", "design-fidelity", "polish"];
+export type JudgeDimension = (typeof JUDGE_DIMENSIONS)[number];
+export declare const judgeScorecardSchema: z.ZodObject<{
+    overall: z.ZodNumber;
+    dimensions: z.ZodArray<z.ZodObject<{
+        name: z.ZodEnum<["visual-quality", "readability", "design-fidelity", "polish"]>;
+        score: z.ZodNumber;
+        note: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }, {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }>, "many">;
+    topFindings: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        detail: z.ZodString;
+        severity: z.ZodEnum<["high", "medium", "low"]>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }, {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    overall: number;
+    dimensions: {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }[];
+    topFindings: {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }[];
+}, {
+    overall: number;
+    dimensions: {
+        name: "visual-quality" | "readability" | "design-fidelity" | "polish";
+        score: number;
+        note: string;
+    }[];
+    topFindings: {
+        title: string;
+        detail: string;
+        severity: "high" | "medium" | "low";
+    }[];
+}>;
+export type JudgeScorecard = z.infer<typeof judgeScorecardSchema>;
+//# sourceMappingURL=judge-scorecard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"judge-scorecard.d.ts","sourceRoot":"","sources":["../src/judge-scorecard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,gBAAgB,yEAKnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/judge-scorecard.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+/**
+ * The quality-judge scorecard contract, shared by the api-server judge route
+ * (which validates what the vision model returned) and the CLI (which
+ * validates the terminal frame before writing `.bitmagic/judge.json`). It
+ * lives here so the two sides can never drift: a scorecard the server accepts
+ * is by construction one the CLI can record and render.
+ *
+ * Dimension names are a fixed enum, not free text, so scores stay comparable
+ * run over run — "readability: 4 → 7" only means something if both runs were
+ * grading the same axis.
+ */
+export const JUDGE_DIMENSIONS = [
+    'visual-quality',
+    'readability',
+    'design-fidelity',
+    'polish',
+];
+export const judgeScorecardSchema = z.object({
+    overall: z.number().min(1).max(10),
+    dimensions: z
+        .array(z.object({
+        name: z.enum(JUDGE_DIMENSIONS),
+        score: z.number().min(1).max(10),
+        note: z.string().max(300),
+    }))
+        .min(1)
+        .max(JUDGE_DIMENSIONS.length),
+    topFindings: z
+        .array(z.object({
+        title: z.string().max(120),
+        // The detail must say what to CHANGE, not just what is wrong; the
+        // prompt enforces the intent, the length cap enforces the discipline.
+        detail: z.string().max(500),
+        severity: z.enum(['high', 'medium', 'low']),
+    }))
+        .max(3),
+});
+//# sourceMappingURL=judge-scorecard.js.map

package/dist/judge-scorecard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-scorecard.js","sourceRoot":"","sources":["../src/judge-scorecard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,gBAAgB;IAChB,aAAa;IACb,iBAAiB;IACjB,QAAQ;CACA,CAAC;AAIX,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;IAClC,UAAU,EAAE,CAAC;SACV,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;QAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;KAC1B,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC;IAC/B,WAAW,EAAE,CAAC;SACX,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;QAC1B,kEAAkE;QAClE,sEAAsE;QACtE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;QAC3B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;KAC5C,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;CACV,CAAC,CAAC"}

package/package.json

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