pixelkiln 0.89.1 → 0.89.3

package/dist/index.cjs

@@ -73,6 +73,7 @@ __export(index_exports, {
   LockEntrySchema: () => LockEntrySchema,
   LockHistoryEntrySchema: () => LockHistoryEntrySchema,
   LockSchema: () => LockSchema,
+  LockTerrainSettingsSchema: () => LockTerrainSettingsSchema,
   MAX_DOWNLOAD_BYTES: () => MAX_DOWNLOAD_BYTES,
   MAX_HAND_EDIT_BYTES: () => MAX_HAND_EDIT_BYTES,
   MAX_RETRIES: () => MAX_RETRIES,
@@ -344,6 +345,7 @@ __export(index_exports, {
   summarize: () => summarize,
   tagAdopted: () => tagAdopted,
   terrainCost: () => terrainCost,
+  terrainSettings: () => terrainSettings,
   terrainTileCount: () => terrainTileCount,
   tileFeatureOutputCount: () => tileFeatureOutputCount,
   tileVariationCount: () => tileVariationCount,
@@ -1693,6 +1695,18 @@ var LockTerrainConnectSchema = import_zod.z.record(
   TerrainSideSchema,
   import_zod.z.object({ sourceAssetId: import_zod.z.string().min(1), sourceObjectId: import_zod.z.string().min(1) }).strict()
 );
+var LockTerrainSettingsSchema = import_zod.z.object({
+  terrainMode: import_zod.z.string().optional(),
+  terrainShapeStyle: import_zod.z.string().optional(),
+  terrainSpreadX: import_zod.z.number().optional(),
+  terrainSlopeSize: import_zod.z.number().optional(),
+  terrainRaggedness: import_zod.z.number().optional(),
+  terrainTransitionSize: import_zod.z.number().optional(),
+  terrainView: import_zod.z.string().optional(),
+  terrainLowerDescription: import_zod.z.string().optional(),
+  terrainUpperDescription: import_zod.z.string().optional(),
+  terrainTransitionDescription: import_zod.z.string().optional()
+});
 var LockHistoryEntrySchema = import_zod.z.object({
   specHash: import_zod.z.string(),
   generator: GeneratorSchema,
@@ -1717,6 +1731,8 @@ var LockHistoryEntrySchema = import_zod.z.object({
   postprocess: PostprocessSchema.optional(),
   /** A connected terrain set's other sets; see LockEntrySchema.terrainConnect. */
   terrainConnect: LockTerrainConnectSchema.optional(),
+  /** A terrain set's settings outside specHash; see LockEntrySchema.terrainSettings. */
+  terrainSettings: LockTerrainSettingsSchema.optional(),
   /** When the replacement was submitted. */
   retiredAt: import_zod.z.string()
 });
@@ -1791,6 +1807,14 @@ var LockEntrySchema = import_zod.z.object({
    * Absent (not null) otherwise, so other entries do not grow the key.
    */
   terrainConnect: LockTerrainConnectSchema.optional(),
+  /**
+   * For a terrain set: the settings it was submitted with that `specHash`
+   * leaves out (see LockTerrainSettingsSchema). The plan marks the entry
+   * stale when the manifest's differ. Absent on entries submitted before
+   * it was recorded, which are taken as current, and on every other
+   * generator's entries.
+   */
+  terrainSettings: LockTerrainSettingsSchema.optional(),
   /**
    * Output hashes owned by the previous generation while its replacement is
    * pending. They authorize replacing only unchanged PixelKiln-owned files.
@@ -4315,8 +4339,9 @@ function specHash(spec, styleImageHashes, providerOptionIdentity = spec.provider
       uiColorPalette: spec.uiColorPalette,
       // The older terrain knobs (terrainMode, terrainTransitionSize, and the
       // rest) were never part of this hash, and adding them now would make
-      // every existing terrain entry stale. The Pro shape controls added
-      // after them are identity, each only when set.
+      // every existing terrain entry stale; terrainSettings below records
+      // them per entry instead. The Pro shape controls added after them are
+      // identity, each only when set.
       terrainRoundness: spec.terrainRoundness,
       terrainBoundaryAmplitude: spec.terrainBoundaryAmplitude,
       terrainBoundarySeed: spec.terrainBoundarySeed,
@@ -4442,6 +4467,22 @@ function specHash(spec, styleImageHashes, providerOptionIdentity = spec.provider
     })
   );
 }
+function terrainSettings(spec) {
+  if (spec.generator !== "terrain") return void 0;
+  const settings = {
+    terrainMode: spec.terrainMode,
+    terrainShapeStyle: spec.terrainShapeStyle,
+    terrainSpreadX: spec.terrainSpreadX,
+    terrainSlopeSize: spec.terrainSlopeSize,
+    terrainRaggedness: spec.terrainRaggedness,
+    terrainTransitionSize: spec.terrainTransitionSize,
+    terrainView: spec.terrainView,
+    terrainLowerDescription: spec.terrainLowerDescription,
+    terrainUpperDescription: spec.terrainUpperDescription,
+    terrainTransitionDescription: spec.terrainTransitionDescription
+  };
+  return Object.fromEntries(Object.entries(settings).filter(([, value]) => value !== void 0));
+}
 
 // src/pixellab-mcp.ts
 var PIXELLAB_MCP_URL = "https://api.pixellab.ai/mcp";
@@ -13364,6 +13405,15 @@ function changedTerrainConnection(spec, entry, lock) {
   }
   return null;
 }
+function changedTerrainSettings(spec, entry) {
+  const recorded = entry.terrainSettings;
+  const current = terrainSettings(spec);
+  if (!recorded || !current) return null;
+  const show = (value) => value === void 0 ? "unset" : JSON.stringify(value);
+  const fields = /* @__PURE__ */ new Set([...Object.keys(recorded), ...Object.keys(current)]);
+  const changes = [...fields].filter((field) => recorded[field] !== current[field]).map((field) => `${field} changed from ${show(recorded[field])} to ${show(current[field])}`);
+  return changes.length ? changes.join("; ") : null;
+}
 function resumeCommandForStatus(status) {
   if (status === "pending" || status === "processing") return "poll";
   if (status === "review") return "pick";
@@ -13396,6 +13446,7 @@ async function buildPlan(specs, lock, opts = {}) {
     let state;
     let reason;
     const changedConnection = entry ? changedTerrainConnection(spec, entry, lock) : null;
+    const changedSettings = entry ? changedTerrainSettings(spec, entry) : null;
     const revision = await inspectRevisionReadiness(spec, lock);
     if (revision && !revision.ready) {
       state = "blocked";
@@ -13434,6 +13485,9 @@ async function buildPlan(specs, lock, opts = {}) {
     } else if (changedConnection) {
       state = "stale";
       reason = `connected set ${changedConnection} was regenerated; draw this set from its new terrain`;
+    } else if (changedSettings) {
+      state = "stale";
+      reason = changedSettings;
     } else if (entry.status === "download-failed") {
       state = "recoverable";
       const force = entry.error?.includes("pass --force") ? " --force" : "";
@@ -14903,6 +14957,7 @@ function retireGeneration(entry, retiredAt) {
     provider: entry.provider,
     postprocess: entry.postprocess,
     ...entry.terrainConnect ? { terrainConnect: entry.terrainConnect } : {},
+    ...entry.terrainSettings ? { terrainSettings: entry.terrainSettings } : {},
     retiredAt
   };
 }
@@ -14997,6 +15052,9 @@ async function revertGeneration(provider, spec, lock, lockPath, opts) {
     // A connected set comes back with the connection it was drawn from, so
     // the plan compares the restored generation, not the one it replaced.
     terrainConnect: generation.terrainConnect,
+    // Likewise its settings; a generation from before they were recorded
+    // comes back with none and is taken as current.
+    terrainSettings: generation.terrainSettings,
     history
   });
   await saveLock(lockPath, lock);
@@ -16074,6 +16132,9 @@ async function submit(provider, loaded, items, lock, lockPath, opts = {}) {
         referenceSha256: spec.character.outfit.reference.sha256
       } : null,
       terrainConnect: spec.terrainConnect ? terrainConnect : void 0,
+      // The terrain knobs specHash leaves out, so the plan can tell a
+      // changed one; undefined (no key) for every other generator.
+      terrainSettings: terrainSettings(spec),
       status: "pending",
       jobId: previousJobId ?? null,
       ...previousJobId ? { submissionComplete: false } : { submissionComplete: void 0 },
@@ -21086,6 +21147,7 @@ async function workspaceStatus(ws, dir) {
   LockEntrySchema,
   LockHistoryEntrySchema,
   LockSchema,
+  LockTerrainSettingsSchema,
   MAX_DOWNLOAD_BYTES,
   MAX_HAND_EDIT_BYTES,
   MAX_RETRIES,
@@ -21357,6 +21419,7 @@ async function workspaceStatus(ws, dir) {
   summarize,
   tagAdopted,
   terrainCost,
+  terrainSettings,
   terrainTileCount,
   tileFeatureOutputCount,
   tileVariationCount,