@bitmagic/world-forger 0.1.0

package/dist/pipeline/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/pipeline/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAEvC,YAAY,OAAe,EAAE,MAAe;QAC1C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/dist/pipeline/forged-work-store.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Forged-work store — the resume state for a world-forger run.
+ *
+ * The pipeline is split into independent steps (design → forge+upload →
+ * archetypes → voxelize → place+persist), some of which take many minutes
+ * (a level bake can run up to 20). To make a failed long step resumable
+ * WITHOUT redoing the expensive ones, every step writes its serializable
+ * output as a small JSON artifact under `worlds/v3/forged-work/{jobId}/`.
+ * A resumed run skips any step whose output artifact already exists.
+ *
+ * Nothing binary crosses a step boundary: the world GLB and each archetype
+ * GLB are uploaded to storage by the forge step and referenced by URL, so
+ * every artifact here is plain JSON.
+ *
+ * jobId is minted fresh per logical run (see {@link newForgeJobId}); a retry
+ * RESUMES by passing the same jobId back. Because each fresh run gets a unique
+ * id, artifacts never collide across unrelated runs — so the store needs no
+ * delete primitive. Leftover artifacts are tiny JSON and consistent with the
+ * un-GC'd source GLB uploads the forge already makes; bucket lifecycle rules
+ * can sweep the prefix.
+ *
+ * Moved from game-play-agent verbatim, keeping the SAME two-parameter seam
+ * (`createForgedWorkStore(jobId, env)`) — see ForgeDeps.storage in deps.ts.
+ * No default `env` here: unlike the game-play-agent original (which defaulted
+ * to `getStorageEnv()`), this package has no host storage config to fall
+ * back to, so every caller must pass one explicitly.
+ */
+import type { ForgeStorageEnv } from './storage-types.js';
+/** One artifact per pipeline step, plus `input` (the job's frozen request) and
+ *  `persisted` (the job-complete marker = the final tool summary). */
+export type ForgeArtifactName = 'input' | 'spec' | 'platformer-movement' | 'forge' | 'archetype-progress' | 'archetype-assets' | 'level-bake' | 'persisted';
+export interface ForgedWorkStore {
+    readonly jobId: string;
+    put(name: ForgeArtifactName, value: unknown): Promise<void>;
+    get<T>(name: ForgeArtifactName): Promise<T | null>;
+    has(name: ForgeArtifactName): Promise<boolean>;
+}
+/** Create a store bound to one jobId, backed by the host's storage env. */
+export declare function createForgedWorkStore(jobId: string, env: ForgeStorageEnv): ForgedWorkStore;
+/**
+ * Mint a fresh, unique job id for a new world-forger run. A retry that wants to
+ * resume passes this id back instead of minting a new one. The level name is
+ * embedded for readability when browsing the bucket.
+ */
+export declare function newForgeJobId(levelName: string): string;
+//# sourceMappingURL=forged-work-store.d.ts.map

package/dist/pipeline/forged-work-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forged-work-store.d.ts","sourceRoot":"","sources":["../../src/pipeline/forged-work-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAK1D;sEACsE;AACtE,MAAM,MAAM,iBAAiB,GACzB,OAAO,GACP,MAAM,GAGN,qBAAqB,GACrB,OAAO,GAIP,oBAAoB,GACpB,kBAAkB,GAClB,YAAY,GACZ,WAAW,CAAC;AAIhB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACnD,GAAG,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAMD,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,GAAG,eAAe,CAuB1F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/pipeline/forged-work-store.js

@@ -0,0 +1,69 @@
+/**
+ * Forged-work store — the resume state for a world-forger run.
+ *
+ * The pipeline is split into independent steps (design → forge+upload →
+ * archetypes → voxelize → place+persist), some of which take many minutes
+ * (a level bake can run up to 20). To make a failed long step resumable
+ * WITHOUT redoing the expensive ones, every step writes its serializable
+ * output as a small JSON artifact under `worlds/v3/forged-work/{jobId}/`.
+ * A resumed run skips any step whose output artifact already exists.
+ *
+ * Nothing binary crosses a step boundary: the world GLB and each archetype
+ * GLB are uploaded to storage by the forge step and referenced by URL, so
+ * every artifact here is plain JSON.
+ *
+ * jobId is minted fresh per logical run (see {@link newForgeJobId}); a retry
+ * RESUMES by passing the same jobId back. Because each fresh run gets a unique
+ * id, artifacts never collide across unrelated runs — so the store needs no
+ * delete primitive. Leftover artifacts are tiny JSON and consistent with the
+ * un-GC'd source GLB uploads the forge already makes; bucket lifecycle rules
+ * can sweep the prefix.
+ *
+ * Moved from game-play-agent verbatim, keeping the SAME two-parameter seam
+ * (`createForgedWorkStore(jobId, env)`) — see ForgeDeps.storage in deps.ts.
+ * No default `env` here: unlike the game-play-agent original (which defaulted
+ * to `getStorageEnv()`), this package has no host storage config to fall
+ * back to, so every caller must pass one explicitly.
+ */
+import { createLogger } from '../log.js';
+const log = createLogger('forged-work-store');
+const PREFIX = 'worlds/v3/forged-work';
+function keyFor(jobId, name) {
+    return `${PREFIX}/${jobId}/${name}.json`;
+}
+/** Create a store bound to one jobId, backed by the host's storage env. */
+export function createForgedWorkStore(jobId, env) {
+    return {
+        jobId,
+        async put(name, value) {
+            await env.storageClient.putObject({
+                bucket: env.bucket,
+                key: keyFor(jobId, name),
+                body: new TextEncoder().encode(JSON.stringify(value)),
+                contentType: 'application/json',
+                // Resume state — must never be served stale from a CDN cache.
+                cacheControl: 'no-store, max-age=0',
+            });
+            log.info({ jobId, artifact: name }, 'Forged-work artifact written');
+        },
+        async get(name) {
+            const bytes = await env.storageClient.getObject({ bucket: env.bucket, key: keyFor(jobId, name) });
+            if (!bytes)
+                return null;
+            return JSON.parse(new TextDecoder().decode(bytes));
+        },
+        async has(name) {
+            return env.storageClient.headObject({ bucket: env.bucket, key: keyFor(jobId, name) });
+        },
+    };
+}
+/**
+ * Mint a fresh, unique job id for a new world-forger run. A retry that wants to
+ * resume passes this id back instead of minting a new one. The level name is
+ * embedded for readability when browsing the bucket.
+ */
+export function newForgeJobId(levelName) {
+    const safe = levelName.replace(/[^a-zA-Z0-9_-]+/g, '_').slice(0, 24) || 'level';
+    return `${safe}-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+//# sourceMappingURL=forged-work-store.js.map

package/dist/pipeline/forged-work-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forged-work-store.js","sourceRoot":"","sources":["../../src/pipeline/forged-work-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,GAAG,GAAG,YAAY,CAAC,mBAAmB,CAAC,CAAC;AAmB9C,MAAM,MAAM,GAAG,uBAAuB,CAAC;AASvC,SAAS,MAAM,CAAC,KAAa,EAAE,IAAuB;IACpD,OAAO,GAAG,MAAM,IAAI,KAAK,IAAI,IAAI,OAAO,CAAC;AAC3C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,GAAoB;IACvE,OAAO;QACL,KAAK;QACL,KAAK,CAAC,GAAG,CAAC,IAAuB,EAAE,KAAc;YAC/C,MAAM,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC;gBAChC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;gBACxB,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACrD,WAAW,EAAE,kBAAkB;gBAC/B,8DAA8D;gBAC9D,YAAY,EAAE,qBAAqB;aACpC,CAAC,CAAC;YACH,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,8BAA8B,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,CAAC,GAAG,CAAI,IAAuB;YAClC,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;YAClG,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAM,CAAC;QAC1D,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAuB;YAC/B,OAAO,GAAG,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACxF,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC;IAChF,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACxF,CAAC"}

package/dist/pipeline/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Public entry point for the CLIENT half of the world-forger pipeline: steps
+ * 3-5 (archetype creation, level bake, place + persist) plus the host seams
+ * they run behind. Reachable as `@bitmagic/world-forger/pipeline/index.js`.
+ *
+ * Steps 1-2 — designing the scene with an LLM and forging its geometry — are
+ * private and are not published. A host that runs the whole five-step pipeline
+ * imports from both halves; a host that only drives the browser (the CLI)
+ * imports only this one.
+ *
+ * (Neither comment names the private package. `publish-npm.yml` hard-fails on
+ * that name appearing anywhere under the packed `dist/`, which is how an
+ * `import type` from it — erased from the .js but preserved verbatim in the
+ * emitted .d.ts — gets caught. A plain string search is only trustworthy if
+ * there is nothing legitimate for it to match.)
+ */
+export * from './storage-types.js';
+export * from './model-types.js';
+export * from './transport-types.js';
+export * from './world-json-types.js';
+export * from './world-json-source.js';
+export * from './deps.js';
+export * from './forged-work-store.js';
+export * from './job-types.js';
+export * from './errors.js';
+export * from './artifact-store.js';
+export * from './asset-catalog.js';
+export * from './create-level-archetypes.js';
+export * from './voxelize-level.js';
+export * from './place-and-persist-level.js';
+export * from './persist-level.js';
+export * from './level-registry.js';
+export * from './spawn-points.js';
+export * from './starter-scatter.js';
+export * from './archetype-skips.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/pipeline/index.js

@@ -0,0 +1,36 @@
+/**
+ * Public entry point for the CLIENT half of the world-forger pipeline: steps
+ * 3-5 (archetype creation, level bake, place + persist) plus the host seams
+ * they run behind. Reachable as `@bitmagic/world-forger/pipeline/index.js`.
+ *
+ * Steps 1-2 — designing the scene with an LLM and forging its geometry — are
+ * private and are not published. A host that runs the whole five-step pipeline
+ * imports from both halves; a host that only drives the browser (the CLI)
+ * imports only this one.
+ *
+ * (Neither comment names the private package. `publish-npm.yml` hard-fails on
+ * that name appearing anywhere under the packed `dist/`, which is how an
+ * `import type` from it — erased from the .js but preserved verbatim in the
+ * emitted .d.ts — gets caught. A plain string search is only trustworthy if
+ * there is nothing legitimate for it to match.)
+ */
+export * from './storage-types.js';
+export * from './model-types.js';
+export * from './transport-types.js';
+export * from './world-json-types.js';
+export * from './world-json-source.js';
+export * from './deps.js';
+export * from './forged-work-store.js';
+export * from './job-types.js';
+export * from './errors.js';
+export * from './artifact-store.js';
+export * from './asset-catalog.js';
+export * from './create-level-archetypes.js';
+export * from './voxelize-level.js';
+export * from './place-and-persist-level.js';
+export * from './persist-level.js';
+export * from './level-registry.js';
+export * from './spawn-points.js';
+export * from './starter-scatter.js';
+export * from './archetype-skips.js';
+//# sourceMappingURL=index.js.map

package/dist/pipeline/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,WAAW,CAAC;AAC1B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,qBAAqB,CAAC;AACpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/pipeline/job-types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Job input & artifact shapes shared across the pipeline steps (all
+ * JSON-serializable — nothing binary crosses a step boundary). Moved from
+ * game-play-agent's `pipeline.ts` verbatim: steps 3-5 (archetype creation,
+ * level bake, place+persist) consume `ForgeJobInput` and `ForgeArtifact`
+ * exactly as produced here.
+ */
+import type { DungeonDoorDef, DungeonKeyItemDef, DungeonLightConfig, ForgedObjectSummary, ForgedPlacement, ForgedSpecView, ForgedTerrainBand, LevelVoxelizeOptions, ResolvedFeature, ResolvedPathFeature, WorldMarker } from '../artifact-types.js';
+import type { ForgedHeightGrid } from '../terrain-height-grid.js';
+/** The frozen request for one run, written once as the `input` artifact. */
+export interface ForgeJobInput {
+    name: string;
+    prompt: string;
+    /** The user's request in their own words (the `prompt` above is the orchestrator's
+     *  paraphrase). Threaded to the director + designer and persisted on the level asset
+     *  so intent survives every handoff. */
+    originalUserPrompt?: string;
+    /** Build a city (street grid + buildings + landmarks) instead of natural terrain. */
+    cityMode?: boolean;
+    /** Build a third-person platformer journey (regions + gated passages + a golden-path spine). */
+    platformerMode?: boolean;
+    /** Build a freeform custom place (arena, fortress, camp — terrain + walk-in structures). */
+    freeformMode?: boolean;
+    /** Build a mission-graph DUNGEON (enclosed rooms + corridors under a flat terrain plate). */
+    dungeonMode?: boolean;
+    /** GAME-DESIGN.md contents (the overall game's type/scope/vision) — frozen at job start so the
+     *  designer builds a level that fits the whole game, not just the prompt. */
+    gameDesign?: string;
+    sizeX?: number;
+    sizeZ?: number;
+    /** Pre-minted level asset id from the orchestrator's manifest. */
+    assetId?: string;
+    /** Explicit boot-level intent: true = the forged level becomes the start
+     *  level, false = keep the current start. Omitted = first forge on a game
+     *  becomes the start; later forges keep the current start. */
+    makeStartLevel?: boolean;
+    maxTerrainSurfaceVoxels?: number;
+    /** Game id resolved from world.json at job start (for upload key namespacing). */
+    gameId: string;
+}
+/** An archetype after its GLB has been uploaded — URL replaces the bytes. */
+export interface ForgeArchetypeRef {
+    name: string;
+    /** Empty string for reused archetypes (no GLB is generated for them). */
+    glbUrl: string;
+    instanceCount: number;
+    collision: boolean;
+    /** Absent for reused archetypes (nothing is voxelized). */
+    assetVoxelOptions?: {
+        minVoxelSize: number;
+        maxVoxelSize: number;
+        fillInterior: boolean;
+        fitBox: {
+            x: number;
+            z: number;
+            height: number;
+        };
+        lod0Budget?: number;
+    };
+    /** Reuses an existing library asset: bake skipped, instances reference this id. */
+    reuse?: {
+        assetId: string;
+        assetName: string;
+    };
+}
+/** The serializable subset of the forged world — `glbBytes` become URLs. */
+export interface ForgeArtifact {
+    glbUrl: string;
+    voxelizeOptions: LevelVoxelizeOptions;
+    archetypes: ForgeArchetypeRef[];
+    placements: ForgedPlacement[];
+    /** World-space terrain heightfield, persisted as a sidecar for post-forge placements. */
+    terrainHeightGrid: ForgedHeightGrid;
+    markers: WorldMarker[];
+    playerStart: WorldMarker;
+    playerStartYaw: number | null;
+    gameplayFeatures: Array<ResolvedFeature | ResolvedPathFeature>;
+    objectSummaries: ForgedObjectSummary[];
+    terrainBands: ForgedTerrainBand[];
+    /** WORLD-space sea level (null = no water). Optional: resumed runs may hold artifacts that predate it. */
+    waterLevelYWorld?: number | null;
+    /** Door leaves in WORLD space. `assetId` is injected at persist, `levelId` by the persist builder. */
+    dungeonDoors?: DungeonDoorDef[];
+    /** Key pickups in WORLD space; same injection points as the doors. */
+    dungeonKeyItems?: DungeonKeyItemDef[];
+    /** Archetype name → the `assets[].light` payload its instances emit (`EnvironmentLightSystem`). */
+    dungeonLightConfigs?: Record<string, DungeonLightConfig>;
+    /**
+     * Authored `#RRGGBB` → emissive strength. Also inside `voxelizeOptions` for
+     * the level bake; mirrored here because the ARCHETYPE bakes need it too and
+     * they run from this artifact alone.
+     */
+    dungeonEmissiveByColor?: Record<string, number>;
+    /**
+     * Uploaded `.bmnav` navmesh sidecar. Compiled against THIS forge's level
+     * transform, so it is uploaded with the GLBs (step 2) and pinned onto the
+     * baked level asset as `navUrl` (step 4).
+     */
+    navUrl?: string;
+    notes: string[];
+    /**
+     * The validated scene spec, carried verbatim onto the level asset record. The
+     * declared type is the NARROWED view (see artifact-types.ts) — the fields the
+     * persist step actually reads — because the full spec's schema is the
+     * designer's, not the client's.
+     */
+    spec: ForgedSpecView;
+}
+/** Result of the level bake (the engine's records). */
+export interface LevelBakeArtifact {
+    vwldUrl: string;
+    bakedRecord: Record<string, unknown>;
+    nonEmptyChunkCount?: number;
+    totalLod0Leaves?: number;
+    totalTrimeshTriangles?: number;
+    /** Bake-time advisories (unmatched emissive colors) surfaced in the summary. */
+    notes?: string[];
+}
+/** The final tool summary — also the `persisted` job-complete marker. */
+export interface ForgeLevelSummary {
+    asset_id: string;
+    asset_name: string;
+    asset_url: string;
+    glb_url: string;
+    player_start: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    markers: Array<{
+        name: string;
+        x: number;
+        y: number;
+        z: number;
+    }>;
+    library_assets: Array<{
+        name: string;
+        asset_id: string;
+        instances: number;
+    }>;
+    gameplay_features: Array<ResolvedFeature | ResolvedPathFeature>;
+    terrain_bands: ForgedTerrainBand[];
+    message: string;
+}
+//# sourceMappingURL=job-types.d.ts.map

package/dist/pipeline/job-types.d.ts.map

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

package/dist/pipeline/job-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=job-types.js.map

package/dist/pipeline/job-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-types.js","sourceRoot":"","sources":["../../src/pipeline/job-types.ts"],"names":[],"mappings":""}

package/dist/pipeline/level-registry.d.ts

@@ -0,0 +1,57 @@
+import type { LevelEntry, WorldJsonModification, WorldJsonShape } from './world-json-types.js';
+/**
+ * Shared helpers for the multi-level registry (`worldProfileData.levels`).
+ * Used by the manage-levels tool, set-map-asset, and the world-forger persist
+ * step so every writer applies the SAME invariants:
+ *
+ * - A level references a `type:'vwld'` asset by id.
+ * - Instances tagged `levelId` belong to that level; untagged = global.
+ * - Legacy mirror: `voxelUrl`, `spawnPoints`, `playerSpawnPosition` always
+ *   mirror the START level so frozen game code boots correctly.
+ * - Conversion moment: the first level entry created for a game with an
+ *   existing baked world (voxelUrl) synthesizes level 1 from that world and
+ *   tags all currently-untagged instances with it.
+ *
+ * Moved here from game-play-agent's `utils/level-registry.ts` (which now
+ * re-exports this module) because the persist step it serves lives in this
+ * package. Pure: it computes modifications, it never applies them.
+ */
+export declare function mintLevelId(): string;
+export declare function getLevels(worldJson: WorldJsonShape): LevelEntry[];
+export declare function isLevelsMode(worldJson: WorldJsonShape): boolean;
+/** The start level entry (startLevelId else levels[0]); null in legacy mode. */
+export declare function getStartLevel(worldJson: WorldJsonShape): LevelEntry | null;
+/**
+ * Legacy-mirror modifications for a START level: frozen game code reads only
+ * `voxelUrl` / `spawnPoints` / `playerSpawnPosition`, so they must track the
+ * start level. Spawn mirrors are only written when the level owns spawn
+ * points — a level without its own spawns inherits the globals, which are
+ * then already correct.
+ */
+export declare function buildStartLevelMirrors(level: LevelEntry, vwldUrl: string): WorldJsonModification[];
+export interface ConversionResult {
+    modifications: WorldJsonModification[];
+    level1: LevelEntry;
+}
+/**
+ * Synthesize level 1 from the game's current baked world (the conversion
+ * moment's first half). Returns null for a procedural game (no voxelUrl);
+ * throws when `voxelUrl` matches no `type:'vwld'` asset (legacy .vxl
+ * heightfield maps and unregistered bakes cannot become levels).
+ */
+export declare function synthesizeLevel1(worldJson: WorldJsonShape): LevelEntry | null;
+/**
+ * Tag every currently-untagged instance with the given level id — after
+ * conversion, "untagged" means global-by-intent, so the legacy content must
+ * not silently become global.
+ */
+export declare function tagUntaggedInstances(instances: Array<Record<string, unknown>>, levelId: string): Array<Record<string, unknown>>;
+/**
+ * Conversion moment: synthesize level 1 from the game's current baked world.
+ *
+ * Returns null when the game is already in levels mode or has no baked world
+ * (procedural — the caller's new level becomes levels[0]). Throws when the
+ * current world is not a registered vwld asset (see synthesizeLevel1).
+ */
+export declare function buildConversionModifications(worldJson: WorldJsonShape): ConversionResult | null;
+//# sourceMappingURL=level-registry.d.ts.map

package/dist/pipeline/level-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"level-registry.d.ts","sourceRoot":"","sources":["../../src/pipeline/level-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE/F;;;;;;;;;;;;;;;;GAgBG;AAEH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,cAAc,GAAG,UAAU,EAAE,CAEjE;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAE/D;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,SAAS,EAAE,cAAc,GAAG,UAAU,GAAG,IAAI,CAK1E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd,qBAAqB,EAAE,CAazB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,GAAG,UAAU,GAAG,IAAI,CAmB7E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,OAAO,EAAE,MAAM,GACd,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEhC;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,cAAc,GAAG,gBAAgB,GAAG,IAAI,CAW/F"}

package/dist/pipeline/level-registry.js

@@ -0,0 +1,108 @@
+/**
+ * Shared helpers for the multi-level registry (`worldProfileData.levels`).
+ * Used by the manage-levels tool, set-map-asset, and the world-forger persist
+ * step so every writer applies the SAME invariants:
+ *
+ * - A level references a `type:'vwld'` asset by id.
+ * - Instances tagged `levelId` belong to that level; untagged = global.
+ * - Legacy mirror: `voxelUrl`, `spawnPoints`, `playerSpawnPosition` always
+ *   mirror the START level so frozen game code boots correctly.
+ * - Conversion moment: the first level entry created for a game with an
+ *   existing baked world (voxelUrl) synthesizes level 1 from that world and
+ *   tags all currently-untagged instances with it.
+ *
+ * Moved here from game-play-agent's `utils/level-registry.ts` (which now
+ * re-exports this module) because the persist step it serves lives in this
+ * package. Pure: it computes modifications, it never applies them.
+ */
+export function mintLevelId() {
+    return `level_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+export function getLevels(worldJson) {
+    return worldJson.worldProfileData?.levels ?? [];
+}
+export function isLevelsMode(worldJson) {
+    return getLevels(worldJson).length > 0;
+}
+/** The start level entry (startLevelId else levels[0]); null in legacy mode. */
+export function getStartLevel(worldJson) {
+    const levels = getLevels(worldJson);
+    if (levels.length === 0)
+        return null;
+    const startId = worldJson.worldProfileData?.startLevelId;
+    return levels.find((l) => l.id === startId) ?? levels[0];
+}
+/**
+ * Legacy-mirror modifications for a START level: frozen game code reads only
+ * `voxelUrl` / `spawnPoints` / `playerSpawnPosition`, so they must track the
+ * start level. Spawn mirrors are only written when the level owns spawn
+ * points — a level without its own spawns inherits the globals, which are
+ * then already correct.
+ */
+export function buildStartLevelMirrors(level, vwldUrl) {
+    const mods = [
+        { type: 'set', path: ['voxelUrl'], value: vwldUrl },
+    ];
+    const spawns = level.spawnPoints ?? [];
+    if (spawns.length > 0) {
+        mods.push({ type: 'set', path: ['spawnPoints'], value: spawns });
+        const playerSpawn = spawns.find((s) => s.type === 'player');
+        if (playerSpawn?.position) {
+            mods.push({ type: 'set', path: ['playerSpawnPosition'], value: playerSpawn.position });
+        }
+    }
+    return mods;
+}
+/**
+ * Synthesize level 1 from the game's current baked world (the conversion
+ * moment's first half). Returns null for a procedural game (no voxelUrl);
+ * throws when `voxelUrl` matches no `type:'vwld'` asset (legacy .vxl
+ * heightfield maps and unregistered bakes cannot become levels).
+ */
+export function synthesizeLevel1(worldJson) {
+    const voxelUrl = worldJson.worldProfileData?.voxelUrl;
+    if (!voxelUrl)
+        return null; // procedural game — nothing to synthesize
+    const vwldAsset = (worldJson.assets ?? []).find((a) => a.type === 'vwld' && a.url === voxelUrl);
+    if (!vwldAsset) {
+        throw new Error('This game\'s current world is not a registered vwld level asset (legacy map or unregistered bake) — re-bake the level before enabling multi-level.');
+    }
+    return {
+        id: mintLevelId(),
+        name: String(vwldAsset.name ?? 'Level 1'),
+        vwldAssetId: String(vwldAsset.id),
+        ...(worldJson.worldProfileData?.spawnPoints?.length
+            ? { spawnPoints: worldJson.worldProfileData.spawnPoints }
+            : {}),
+    };
+}
+/**
+ * Tag every currently-untagged instance with the given level id — after
+ * conversion, "untagged" means global-by-intent, so the legacy content must
+ * not silently become global.
+ */
+export function tagUntaggedInstances(instances, levelId) {
+    return instances.map((o) => (o.levelId === undefined ? { ...o, levelId } : o));
+}
+/**
+ * Conversion moment: synthesize level 1 from the game's current baked world.
+ *
+ * Returns null when the game is already in levels mode or has no baked world
+ * (procedural — the caller's new level becomes levels[0]). Throws when the
+ * current world is not a registered vwld asset (see synthesizeLevel1).
+ */
+export function buildConversionModifications(worldJson) {
+    if (isLevelsMode(worldJson))
+        return null;
+    const level1 = synthesizeLevel1(worldJson);
+    if (!level1)
+        return null;
+    const tagged = tagUntaggedInstances(worldJson.environmentObjects ?? [], level1.id);
+    const modifications = [
+        { type: 'set', path: ['levels'], value: [level1] },
+        { type: 'set', path: ['startLevelId'], value: level1.id },
+        { type: 'setRoot', path: ['environmentObjects'], value: tagged },
+    ];
+    return { modifications, level1 };
+}
+//# sourceMappingURL=level-registry.js.map

package/dist/pipeline/level-registry.js.map

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

package/dist/pipeline/model-types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * The model seam — the LLM client the director and designer call through.
+ *
+ * Shape mirrors the `ai` SDK's `LanguageModelUsage` (already the usage shape
+ * `streamText(...).usage` resolves to everywhere else in game-play-agent),
+ * not a reinvented one: the web lane's `ForgeModelClient` hands this back
+ * almost verbatim, and api-server's CLI-lane host prices straight from it
+ * without reshaping (`cli-forge.ts`'s `priceForgeUsageSparks`). `model` is
+ * the id that actually SERVED the call (from
+ * the provider's response, e.g. `LanguageModelResponseMetadata.modelId`) —
+ * fallback middleware can swap models mid-flight, and pricing must key on
+ * what ran, not what was requested.
+ *
+ * The designer permits up to MAX_ATTEMPTS design attempts (each up to 64k
+ * output tokens) plus JSON-repair calls, and the director makes its own
+ * calls — every one of them goes through `generateText` and reports its own
+ * usage here. Summing a job's cost is therefore the HOST's job (it is the
+ * one implementing this interface, so it sees every call as it happens);
+ * this package never aggregates usage itself.
+ */
+export interface ForgeModelUsage {
+    /** The model id that actually served this call. */
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    /** Cached-read input tokens, when the provider reports them. */
+    cacheReadTokens?: number;
+    /** Cache-write (cache-creation) input tokens, when the provider reports them. */
+    cacheWriteTokens?: number;
+}
+export interface ForgeModelResult {
+    text: string;
+    usage: ForgeModelUsage;
+}
+export interface ForgeModelGenerateParams {
+    system: string;
+    prompt: string;
+    /** Output-token ceiling. The designer sets this explicitly and deliberately
+     *  large (see DESIGNER_MAX_OUTPUT_TOKENS in designer.ts) — omit only for
+     *  small calls (the director's one-line decision) where a provider default
+     *  is fine. */
+    maxOutputTokens?: number;
+}
+/** The LLM seam the designer + director call through. No model selection,
+ *  no fallback policy, no provider SDK — the host decides all of that and
+ *  hands in a client that already embeds the choice. */
+export interface ForgeModelClient {
+    generateText(params: ForgeModelGenerateParams): Promise<ForgeModelResult>;
+}
+//# sourceMappingURL=model-types.d.ts.map

package/dist/pipeline/model-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-types.d.ts","sourceRoot":"","sources":["../../src/pipeline/model-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;;mBAGe;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;wDAEwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC3E"}

package/dist/pipeline/model-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-types.js.map

package/dist/pipeline/model-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-types.js","sourceRoot":"","sources":["../../src/pipeline/model-types.ts"],"names":[],"mappings":""}