@nodetool-ai/agents 0.7.0-rc.22 → 0.8.1

package/dist/game-examples.d.ts

@@ -0,0 +1,447 @@
+import { z } from "zod";
+import { type ExampleGameSummary, type GameDocument } from "@nodetool-ai/protocol/game.js";
+import { type StorageAdapter } from "@nodetool-ai/storage";
+declare const bundleSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    controls: z.ZodString;
+    posterUri: z.ZodString;
+    document: z.ZodObject<{
+        schemaVersion: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>;
+        engineVersion: z.ZodLiteral<"1">;
+        id: z.ZodString;
+        revision: z.ZodString;
+        entrySceneId: z.ZodString;
+        pixelsPerUnit: z.ZodNumber;
+        tickRate: z.ZodLiteral<60>;
+        inputActions: z.ZodArray<z.ZodString>;
+        collisionLayers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        renderEffects: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            kind: z.ZodLiteral<"brightnessContrast">;
+            brightness: z.ZodNumber;
+            contrast: z.ZodNumber;
+            required: z.ZodBoolean;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"bloom">;
+            threshold: z.ZodDefault<z.ZodNumber>;
+            softness: z.ZodDefault<z.ZodNumber>;
+            radius: z.ZodDefault<z.ZodNumber>;
+            intensity: z.ZodDefault<z.ZodNumber>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>, z.ZodObject<{
+            kind: z.ZodLiteral<"lut">;
+            assetId: z.ZodString;
+            size: z.ZodNumber;
+            intensity: z.ZodDefault<z.ZodNumber>;
+            domainMin: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            domainMax: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+            required: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strict>], "kind">>>;
+        hudEffectOrder: z.ZodOptional<z.ZodEnum<{
+            afterEffects: "afterEffects";
+            beforeEffects: "beforeEffects";
+        }>>;
+        assets: z.ZodRecord<z.ZodString, z.ZodObject<{
+            assetId: z.ZodString;
+            digest: z.ZodString;
+            mediaKind: z.ZodDefault<z.ZodEnum<{
+                audio: "audio";
+                font: "font";
+                image: "image";
+            }>>;
+            fontFormat: z.ZodOptional<z.ZodEnum<{
+                otf: "otf";
+                ttf: "ttf";
+            }>>;
+            width: z.ZodNumber;
+            height: z.ZodNumber;
+            frame: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            pivot: z.ZodDefault<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>>;
+            sampling: z.ZodDefault<z.ZodEnum<{
+                linear: "linear";
+                nearest: "nearest";
+            }>>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            preparation: z.ZodOptional<z.ZodObject<{
+                trimAlpha: z.ZodBoolean;
+                targetWidth: z.ZodOptional<z.ZodNumber>;
+                targetHeight: z.ZodOptional<z.ZodNumber>;
+                cropPolicy: z.ZodOptional<z.ZodEnum<{
+                    contain: "contain";
+                    cover: "cover";
+                    stretch: "stretch";
+                }>>;
+                mirrorX: z.ZodBoolean;
+                mirrorY: z.ZodBoolean;
+                sheet: z.ZodOptional<z.ZodObject<{
+                    cols: z.ZodNumber;
+                    rows: z.ZodNumber;
+                    baseline: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+                tileset: z.ZodOptional<z.ZodObject<{
+                    tileWidth: z.ZodDefault<z.ZodNumber>;
+                    tileHeight: z.ZodDefault<z.ZodNumber>;
+                    edges: z.ZodDefault<z.ZodNumber>;
+                    highlight: z.ZodDefault<z.ZodNumber>;
+                    shadow: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>>;
+                lut: z.ZodOptional<z.ZodObject<{
+                    size: z.ZodDefault<z.ZodNumber>;
+                    brightness: z.ZodDefault<z.ZodNumber>;
+                    contrast: z.ZodDefault<z.ZodNumber>;
+                    saturation: z.ZodDefault<z.ZodNumber>;
+                    lift: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                    gain: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                    gamma: z.ZodDefault<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            originalDimensions: z.ZodOptional<z.ZodObject<{
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+            }, z.core.$strict>>;
+            trim: z.ZodOptional<z.ZodObject<{
+                sourceWidth: z.ZodNumber;
+                sourceHeight: z.ZodNumber;
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>>;
+            referenceAssetId: z.ZodOptional<z.ZodString>;
+            provenance: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        scenes: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            music: z.ZodOptional<z.ZodObject<{
+                assetId: z.ZodString;
+                volume: z.ZodDefault<z.ZodNumber>;
+                fadeInTicks: z.ZodDefault<z.ZodNumber>;
+                fadeOutTicks: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+            lighting: z.ZodOptional<z.ZodObject<{
+                required: z.ZodOptional<z.ZodBoolean>;
+                ambient: z.ZodObject<{
+                    color: z.ZodString;
+                    intensity: z.ZodNumber;
+                }, z.core.$strict>;
+                points: z.ZodArray<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    color: z.ZodString;
+                    intensity: z.ZodNumber;
+                    radius: z.ZodNumber;
+                    falloff: z.ZodNumber;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            gravity: z.ZodOptional<z.ZodObject<{
+                x: z.ZodNumber;
+                y: z.ZodNumber;
+            }, z.core.$strict>>;
+            entities: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodDefault<z.ZodString>;
+                parentId: z.ZodOptional<z.ZodString>;
+                templateOnly: z.ZodDefault<z.ZodBoolean>;
+                transform2d: z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    rotation: z.ZodDefault<z.ZodNumber>;
+                    scaleX: z.ZodDefault<z.ZodNumber>;
+                    scaleY: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>;
+                sprite: z.ZodOptional<z.ZodObject<{
+                    assetId: z.ZodString;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                    layer: z.ZodDefault<z.ZodNumber>;
+                    frame: z.ZodOptional<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        width: z.ZodNumber;
+                        height: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    tint: z.ZodOptional<z.ZodString>;
+                    opacity: z.ZodOptional<z.ZodNumber>;
+                    blend: z.ZodOptional<z.ZodEnum<{
+                        additive: "additive";
+                        normal: "normal";
+                    }>>;
+                    unlit: z.ZodOptional<z.ZodBoolean>;
+                    flipX: z.ZodOptional<z.ZodBoolean>;
+                    faceMotion: z.ZodOptional<z.ZodEnum<{
+                        left: "left";
+                        right: "right";
+                    }>>;
+                }, z.core.$strict>>;
+                tilemap: z.ZodOptional<z.ZodObject<{
+                    assetId: z.ZodString;
+                    tiles: z.ZodArray<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        width: z.ZodNumber;
+                        height: z.ZodNumber;
+                        frame: z.ZodOptional<z.ZodObject<{
+                            x: z.ZodNumber;
+                            y: z.ZodNumber;
+                            width: z.ZodNumber;
+                            height: z.ZodNumber;
+                        }, z.core.$strict>>;
+                        solid: z.ZodOptional<z.ZodBoolean>;
+                        oneWay: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strict>>;
+                    layer: z.ZodDefault<z.ZodNumber>;
+                    solid: z.ZodOptional<z.ZodBoolean>;
+                    category: z.ZodOptional<z.ZodNumber>;
+                    mask: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+                camera2d: z.ZodOptional<z.ZodObject<{
+                    zoom: z.ZodDefault<z.ZodNumber>;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>>;
+                body2d: z.ZodOptional<z.ZodObject<{
+                    type: z.ZodEnum<{
+                        kinematic: "kinematic";
+                        static: "static";
+                    }>;
+                    velocity: z.ZodDefault<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    gravityScale: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+                collider2d: z.ZodOptional<z.ZodObject<{
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                    sensor: z.ZodDefault<z.ZodBoolean>;
+                    category: z.ZodDefault<z.ZodNumber>;
+                    mask: z.ZodDefault<z.ZodNumber>;
+                    oneWay: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>>;
+                animator: z.ZodOptional<z.ZodObject<{
+                    frames: z.ZodArray<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                        width: z.ZodNumber;
+                        height: z.ZodNumber;
+                    }, z.core.$strict>>;
+                    ticksPerFrame: z.ZodNumber;
+                    loop: z.ZodDefault<z.ZodBoolean>;
+                    clips: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                        frames: z.ZodArray<z.ZodObject<{
+                            x: z.ZodNumber;
+                            y: z.ZodNumber;
+                            width: z.ZodNumber;
+                            height: z.ZodNumber;
+                        }, z.core.$strict>>;
+                        ticksPerFrame: z.ZodNumber;
+                        loop: z.ZodDefault<z.ZodBoolean>;
+                    }, z.core.$strict>>>;
+                }, z.core.$strict>>;
+                light2d: z.ZodOptional<z.ZodObject<{
+                    color: z.ZodString;
+                    intensity: z.ZodNumber;
+                    radius: z.ZodNumber;
+                    falloff: z.ZodDefault<z.ZodNumber>;
+                    offset: z.ZodOptional<z.ZodObject<{
+                        x: z.ZodNumber;
+                        y: z.ZodNumber;
+                    }, z.core.$strict>>;
+                }, z.core.$strict>>;
+                visualAnimation: z.ZodOptional<z.ZodObject<{
+                    tracks: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        durationTicks: z.ZodNumber;
+                        delayTicks: z.ZodDefault<z.ZodNumber>;
+                        repeat: z.ZodDefault<z.ZodBoolean>;
+                        pingPong: z.ZodDefault<z.ZodBoolean>;
+                        easing: z.ZodDefault<z.ZodEnum<{
+                            easeIn: "easeIn";
+                            easeInOut: "easeInOut";
+                            easeOut: "easeOut";
+                            linear: "linear";
+                        }>>;
+                        property: z.ZodLiteral<"opacity" | "rotation" | "scaleX" | "scaleY">;
+                        from: z.ZodNumber;
+                        to: z.ZodNumber;
+                    }, z.core.$strict>, z.ZodObject<{
+                        durationTicks: z.ZodNumber;
+                        delayTicks: z.ZodDefault<z.ZodNumber>;
+                        repeat: z.ZodDefault<z.ZodBoolean>;
+                        pingPong: z.ZodDefault<z.ZodBoolean>;
+                        easing: z.ZodDefault<z.ZodEnum<{
+                            easeIn: "easeIn";
+                            easeInOut: "easeInOut";
+                            easeOut: "easeOut";
+                            linear: "linear";
+                        }>>;
+                        property: z.ZodLiteral<"opacity" | "rotation" | "scaleX" | "scaleY">;
+                        from: z.ZodNumber;
+                        to: z.ZodNumber;
+                    }, z.core.$strict>, z.ZodObject<{
+                        durationTicks: z.ZodNumber;
+                        delayTicks: z.ZodDefault<z.ZodNumber>;
+                        repeat: z.ZodDefault<z.ZodBoolean>;
+                        pingPong: z.ZodDefault<z.ZodBoolean>;
+                        easing: z.ZodDefault<z.ZodEnum<{
+                            easeIn: "easeIn";
+                            easeInOut: "easeInOut";
+                            easeOut: "easeOut";
+                            linear: "linear";
+                        }>>;
+                        property: z.ZodLiteral<"opacity" | "rotation" | "scaleX" | "scaleY">;
+                        from: z.ZodNumber;
+                        to: z.ZodNumber;
+                    }, z.core.$strict>, z.ZodObject<{
+                        durationTicks: z.ZodNumber;
+                        delayTicks: z.ZodDefault<z.ZodNumber>;
+                        repeat: z.ZodDefault<z.ZodBoolean>;
+                        pingPong: z.ZodDefault<z.ZodBoolean>;
+                        easing: z.ZodDefault<z.ZodEnum<{
+                            easeIn: "easeIn";
+                            easeInOut: "easeInOut";
+                            easeOut: "easeOut";
+                            linear: "linear";
+                        }>>;
+                        property: z.ZodLiteral<"opacity" | "rotation" | "scaleX" | "scaleY">;
+                        from: z.ZodNumber;
+                        to: z.ZodNumber;
+                    }, z.core.$strict>, z.ZodObject<{
+                        durationTicks: z.ZodNumber;
+                        delayTicks: z.ZodDefault<z.ZodNumber>;
+                        repeat: z.ZodDefault<z.ZodBoolean>;
+                        pingPong: z.ZodDefault<z.ZodBoolean>;
+                        easing: z.ZodDefault<z.ZodEnum<{
+                            easeIn: "easeIn";
+                            easeInOut: "easeInOut";
+                            easeOut: "easeOut";
+                            linear: "linear";
+                        }>>;
+                        property: z.ZodLiteral<"tint">;
+                        from: z.ZodString;
+                        to: z.ZodString;
+                    }, z.core.$strict>], "property">>>;
+                    rotationRate: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strict>>;
+                audioSource: z.ZodOptional<z.ZodObject<{
+                    assetId: z.ZodString;
+                    onEvent: z.ZodString;
+                    volume: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>>;
+                behaviors: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    kind: z.ZodLiteral<"movement">;
+                    speed: z.ZodNumber;
+                    left: z.ZodString;
+                    right: z.ZodString;
+                    up: z.ZodString;
+                    down: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"patrol">;
+                    speed: z.ZodNumber;
+                    distance: z.ZodNumber;
+                    axis: z.ZodEnum<{
+                        x: "x";
+                        y: "y";
+                    }>;
+                    turnAtLedges: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"collectible">;
+                    score: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"health">;
+                    maximum: z.ZodNumber;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"trigger">;
+                    event: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"spawn">;
+                    prefabId: z.ZodString;
+                    onEvent: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"sceneTransition">;
+                    sceneId: z.ZodString;
+                    onEvent: z.ZodString;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"winWhenCollected">;
+                    count: z.ZodNumber;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"lifetime">;
+                    ticks: z.ZodNumber;
+                    fade: z.ZodDefault<z.ZodBoolean>;
+                    endScale: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>, z.ZodObject<{
+                    kind: z.ZodLiteral<"script">;
+                    source: z.ZodString;
+                    maxCommands: z.ZodDefault<z.ZodNumber>;
+                    maxTickMs: z.ZodDefault<z.ZodNumber>;
+                }, z.core.$strict>], "kind">>>;
+            }, z.core.$strict>>;
+            backgrounds: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                assetId: z.ZodString;
+                width: z.ZodNumber;
+                height: z.ZodNumber;
+                layer: z.ZodDefault<z.ZodNumber>;
+                origin: z.ZodDefault<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strict>>;
+                parallax: z.ZodDefault<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strict>>;
+                scrollRate: z.ZodDefault<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                }, z.core.$strict>>;
+                mode: z.ZodDefault<z.ZodEnum<{
+                    mirror: "mirror";
+                    none: "none";
+                    repeat: "repeat";
+                    repeatX: "repeatX";
+                }>>;
+                frame: z.ZodOptional<z.ZodObject<{
+                    x: z.ZodNumber;
+                    y: z.ZodNumber;
+                    width: z.ZodNumber;
+                    height: z.ZodNumber;
+                }, z.core.$strict>>;
+                sampling: z.ZodOptional<z.ZodEnum<{
+                    linear: "linear";
+                    nearest: "nearest";
+                }>>;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ExampleGameBundle = z.infer<typeof bundleSchema>;
+export interface ExampleGameOptions {
+    examplesDir?: string;
+    packageAssetsRoots?: string[];
+}
+/** Resolve the shipped game directory beside example workflows. */
+export declare function resolveExampleGamesDir(options?: ExampleGameOptions): string | null;
+/** Read one validated, shipped game bundle by exact slug. */
+export declare function getExampleGameBundle(options: ExampleGameOptions, slug: string): ExampleGameBundle | null;
+/** List lightweight cards for the Examples page. */
+export declare function listExampleGames(options: ExampleGameOptions): ExampleGameSummary[];
+/** Read a shipped `package://` file, refusing paths that leave its root. */
+export declare function readExampleGameFile(options: ExampleGameOptions, uri: string): Uint8Array | null;
+/**
+ * Copy every asset a bundle binds into the user's assets and return the
+ * document rebound to the new rows. On failure the rows and stored bytes
+ * written so far are removed.
+ */
+export declare function installExampleGameAssets(userId: string, projectId: string, options: ExampleGameOptions, slug: string, storage: StorageAdapter): Promise<{
+    bundle: ExampleGameBundle;
+    document: GameDocument;
+    rollback: () => Promise<void>;
+}>;
+export {};
+//# sourceMappingURL=game-examples.d.ts.map

package/dist/game-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-examples.d.ts","sourceRoot":"","sources":["../src/game-examples.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAClB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3E,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAMP,CAAC;AACZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAc7D,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,kBAAuB,GAAG,MAAM,GAAG,IAAI,CAetF;AAkBD,6DAA6D;AAC7D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAKxG;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAgBlF;AAgBD,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAe/F;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,kBAAkB,EAC3B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CA4C/F"}

package/dist/game-examples.js

@@ -0,0 +1,187 @@
+/**
+ * Shipped example games.
+ *
+ * A bundle is `examples/games/<slug>.game.json`, built by
+ * `scripts/example-games/build.mjs`. Its document binds every asset slot to a
+ * `package://` file under the package asset root, because a game document
+ * binds user asset rows and a shipped file has none. Installing a bundle
+ * copies each file into the user's assets and rebinds the slot to the new row.
+ */
+import { createHash } from "node:crypto";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import nodePath from "node:path";
+import { z } from "zod";
+import { Asset } from "@nodetool-ai/models";
+import { parsePackageAssetUri } from "@nodetool-ai/protocol";
+import { gameDocument } from "@nodetool-ai/protocol/game.js";
+import { assetObjectKey } from "@nodetool-ai/storage";
+const SUFFIX = ".game.json";
+const bundleSchema = z.object({
+    name: z.string().min(1),
+    description: z.string().min(1),
+    controls: z.string().min(1),
+    posterUri: z.string(),
+    document: gameDocument
+}).strict();
+const CONTENT_TYPES = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".webp": "image/webp",
+    ".wav": "audio/wav",
+    ".mp3": "audio/mpeg",
+    ".ogg": "audio/ogg",
+    ".ttf": "font/ttf",
+    ".otf": "font/otf"
+};
+/** Resolve the shipped game directory beside example workflows. */
+export function resolveExampleGamesDir(options = {}) {
+    if (options.examplesDir) {
+        const dir = nodePath.join(nodePath.dirname(options.examplesDir), "games");
+        return existsSync(dir) ? dir : null;
+    }
+    const override = process.env["NODETOOL_EXAMPLE_GAMES_DIR"];
+    if (override)
+        return existsSync(override) ? override : null;
+    let cursor = nodePath.dirname(fileURLToPath(import.meta.url));
+    for (let depth = 0; depth < 8; depth += 1) {
+        for (const dir of [nodePath.join(cursor, "examples", "games"), nodePath.join(cursor, "packages", "base-nodes", "nodetool", "examples", "games")]) {
+            if (existsSync(dir))
+                return dir;
+        }
+        cursor = nodePath.dirname(cursor);
+    }
+    return null;
+}
+function files(dir) {
+    try {
+        return readdirSync(dir).filter((file) => file.endsWith(SUFFIX)).sort();
+    }
+    catch {
+        return [];
+    }
+}
+function readBundle(dir, file) {
+    try {
+        return bundleSchema.parse(JSON.parse(readFileSync(nodePath.join(dir, file), "utf8")));
+    }
+    catch {
+        return null;
+    }
+}
+/** Read one validated, shipped game bundle by exact slug. */
+export function getExampleGameBundle(options, slug) {
+    const dir = resolveExampleGamesDir(options);
+    if (!dir)
+        return null;
+    const file = files(dir).find((entry) => entry.slice(0, -SUFFIX.length) === slug);
+    return file ? readBundle(dir, file) : null;
+}
+/** List lightweight cards for the Examples page. */
+export function listExampleGames(options) {
+    const dir = resolveExampleGamesDir(options);
+    if (!dir)
+        return [];
+    return files(dir).flatMap((file) => {
+        const bundle = readBundle(dir, file);
+        if (!bundle || !parsePackageAssetUri(bundle.posterUri))
+            return [];
+        return [{
+                slug: file.slice(0, -SUFFIX.length),
+                name: bundle.name,
+                description: bundle.description,
+                controls: bundle.controls,
+                sceneCount: bundle.document.scenes.length,
+                assetCount: Object.keys(bundle.document.assets).length,
+                posterUri: bundle.posterUri
+            }];
+    });
+}
+/**
+ * The package asset roots to search: the server's configured roots, then the
+ * `assets/` directory beside `examples/`, which is where the monorepo and the
+ * packaged backend both stage them.
+ */
+function packageRoots(options) {
+    const roots = [...(options.packageAssetsRoots ?? [])];
+    const gamesDir = resolveExampleGamesDir(options);
+    if (gamesDir) {
+        roots.push(nodePath.join(nodePath.dirname(nodePath.dirname(gamesDir)), "assets"));
+    }
+    return roots;
+}
+/** Read a shipped `package://` file, refusing paths that leave its root. */
+export function readExampleGameFile(options, uri) {
+    const ref = parsePackageAssetUri(uri);
+    if (!ref)
+        return null;
+    for (const root of packageRoots(options)) {
+        const base = nodePath.resolve(root, ref.packageName);
+        const candidate = nodePath.resolve(base, ...ref.path.split("/"));
+        const rel = nodePath.relative(base, candidate);
+        if (rel.startsWith("..") || nodePath.isAbsolute(rel))
+            continue;
+        try {
+            return readFileSync(candidate);
+        }
+        catch {
+            // Not under this root; try the next one.
+        }
+    }
+    return null;
+}
+/**
+ * Copy every asset a bundle binds into the user's assets and return the
+ * document rebound to the new rows. On failure the rows and stored bytes
+ * written so far are removed.
+ */
+export async function installExampleGameAssets(userId, projectId, options, slug, storage) {
+    const bundle = getExampleGameBundle(options, slug);
+    if (!bundle) {
+        throw new Error(`No example game named "${slug}"`);
+    }
+    const created = [];
+    const rollback = async () => {
+        for (const { asset, uri } of created.reverse()) {
+            if (uri)
+                await storage.delete(uri);
+            await asset.delete();
+        }
+    };
+    const assets = {};
+    try {
+        for (const [slot, binding] of Object.entries(bundle.document.assets)) {
+            const bytes = readExampleGameFile(options, binding.assetId);
+            if (!bytes) {
+                throw new Error(`Example game "${slug}" is missing ${binding.assetId}`);
+            }
+            if (createHash("sha256").update(bytes).digest("hex") !== binding.digest) {
+                throw new Error(`Example game "${slug}" file changed: ${binding.assetId}`);
+            }
+            const extension = nodePath.extname(binding.assetId).toLowerCase();
+            const contentType = CONTENT_TYPES[extension] ?? "application/octet-stream";
+            const asset = await Asset.create({
+                user_id: userId,
+                project_id: projectId,
+                parent_id: userId,
+                name: `${slug}-${slot}${extension}`,
+                content_type: contentType,
+                size: bytes.byteLength,
+                metadata: { example_game: slug, game_digest: binding.digest }
+            });
+            if (!(asset instanceof Asset))
+                throw new Error("Failed to create example game asset");
+            const entry = { asset, uri: null };
+            created.push(entry);
+            entry.uri = await storage.store(assetObjectKey(userId, `${asset.id}${extension}`), bytes, contentType);
+            assets[slot] = { ...binding, assetId: asset.id };
+        }
+    }
+    catch (error) {
+        await rollback();
+        throw error;
+    }
+    return { bundle, document: { ...bundle.document, assets }, rollback };
+}
+//# sourceMappingURL=game-examples.js.map

package/dist/game-examples.js.map

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