@pixerate/editor 0.79.0 → 0.81.0

package/dist/generation/index.js

@@ -1101,6 +1101,153 @@ function createGenerationToolProvider(options) {
   };
 }
 
+// src/generation/assets.ts
+function toAssetResolver(lookup) {
+  if (!lookup) return void 0;
+  if (typeof lookup === "function") return (id) => lookup(id) ?? void 0;
+  if (lookup instanceof Map) return (id) => lookup.get(id);
+  const byId = new Map(lookup.map((asset) => [asset.id, asset]));
+  return (id) => byId.get(id);
+}
+function roleCap(caps, role) {
+  const cap = caps.references?.roles[role];
+  if (cap && cap.max > 0) return cap;
+  if (role === "mask" && caps.inpainting) return { max: 1 };
+  return void 0;
+}
+function getAssetRoleOptions(caps) {
+  const roles = supportedReferenceRoles(caps);
+  if (caps.inpainting && !roles.includes("mask")) roles.push("mask");
+  return roles.map((role) => {
+    const cap = roleCap(caps, role) ?? { max: 1 };
+    return {
+      role,
+      label: referenceRoleLabel(role, caps),
+      ...cap.description ? { description: cap.description } : {},
+      min: cap.min ?? 0,
+      max: cap.max,
+      ...cap.accepts?.length ? { accepts: [...cap.accepts] } : {}
+    };
+  });
+}
+function validateAssetMentions(mentions, caps, options = {}) {
+  const resolve = toAssetResolver(options.assets);
+  const issues = [];
+  const counts = {};
+  mentions.forEach((mention, index) => {
+    const id = mention.id;
+    const label = `@${mention.label ?? id}`;
+    if (!mention.role) {
+      issues.push({ index, id, code: "missing-role", severity: "warning", message: `${label} has no role.` });
+      return;
+    }
+    let role = mention.role;
+    if (!roleCap(caps, role)) {
+      const alias = normalizeReferenceRole(role, caps);
+      if (alias !== role && roleCap(caps, alias)) {
+        issues.push({
+          index,
+          id,
+          role,
+          code: "renamed-role",
+          severity: "warning",
+          suggestion: alias,
+          message: `${label}: this model calls "${role}" ${referenceRoleLabel(alias, caps)} (${alias}).`
+        });
+        role = alias;
+      } else {
+        issues.push({
+          index,
+          id,
+          role,
+          code: "unsupported-role",
+          severity: "error",
+          message: `${label}: ${caps.name ?? caps.id} does not accept ${referenceRoleLabel(role, caps).toLowerCase()} assets.`
+        });
+        return;
+      }
+    }
+    const cap = roleCap(caps, role);
+    const mediaType = mention.mediaType ?? resolve?.(id)?.mediaType;
+    if (mediaType !== void 0 && !mediaTypeMatches(mediaType, cap.accepts)) {
+      issues.push({
+        index,
+        id,
+        role,
+        code: "media-mismatch",
+        severity: "error",
+        message: `${label} is ${mediaType}; ${referenceRoleLabel(role, caps)} accepts ${(cap.accepts ?? []).join(", ")}.`
+      });
+      return;
+    }
+    counts[role] = (counts[role] ?? 0) + 1;
+    if (counts[role] > cap.max) {
+      issues.push({
+        index,
+        id,
+        role,
+        code: "too-many",
+        severity: "warning",
+        message: `${label}: at most ${cap.max} ${referenceRoleLabel(role, caps).toLowerCase()} asset(s); extra ones are left out.`
+      });
+    }
+  });
+  const missing = getAssetRoleOptions(caps).filter((option) => (counts[option.role] ?? 0) < option.min).map((option) => ({ role: option.role, min: option.min, count: counts[option.role] ?? 0 }));
+  return { ok: !issues.some((issue) => issue.severity === "error") && missing.length === 0, issues, counts, missing };
+}
+function resolveAssetMentions(mentions, assets) {
+  const byId = new Map(assets.map((asset) => [asset.id, asset]));
+  const byLabel = new Map(assets.filter((a) => a.label).map((asset) => [asset.label.toLowerCase(), asset]));
+  const result = [];
+  for (const mention of mentions) {
+    const asset = byId.get(mention.handle) ?? byLabel.get(mention.handle.toLowerCase());
+    if (!asset) continue;
+    result.push({
+      id: asset.id,
+      label: mention.handle,
+      ...mention.role ? { role: mention.role } : {},
+      ...asset.mediaType !== void 0 ? { mediaType: asset.mediaType } : {},
+      ...asset.contentHash !== void 0 ? { contentHash: asset.contentHash } : {},
+      ...asset.url !== void 0 ? { url: asset.url } : {}
+    });
+  }
+  return result;
+}
+function defaultAssetRoleOptions() {
+  return REFERENCE_ROLES.map((role) => ({ role, label: referenceRoleLabel(role), min: 0, max: 1 }));
+}
+function describeAssetMentions(mentions, assets, caps) {
+  const byId = new Map(assets.map((asset) => [asset.id, asset]));
+  const byLabel = new Map(assets.filter((a) => a.label).map((asset) => [asset.label.toLowerCase(), asset]));
+  const chips = [];
+  for (const mention of mentions) {
+    const asset = byId.get(mention.handle) ?? byLabel.get(mention.handle.toLowerCase());
+    if (!asset) continue;
+    const role = mention.role || void 0;
+    chips.push({
+      index: chips.length,
+      ...mention.start !== void 0 ? { start: mention.start } : {},
+      handle: mention.handle,
+      asset,
+      ...role ? { role, roleLabel: referenceRoleLabel(caps ? normalizeReferenceRole(role, caps) : role, caps) } : {},
+      issues: []
+    });
+  }
+  if (caps) {
+    const validation = validateAssetMentions(
+      chips.map((chip) => ({
+        id: chip.asset.id,
+        label: chip.handle,
+        ...chip.role ? { role: chip.role } : {},
+        ...chip.asset.mediaType ? { mediaType: chip.asset.mediaType } : {}
+      })),
+      caps
+    );
+    for (const issue of validation.issues) chips[issue.index].issues.push(issue);
+  }
+  return chips;
+}
+
 // src/generation/provenance.ts
 var PROVENANCE_FORMAT = "pixerate.generation-provenance";
 var PROVENANCE_VERSION = 1;
@@ -1233,849 +1380,842 @@ function replayProvenancePrompt(provenance) {
   return { text: result.text, map: result.map, matches: result.text === provenance.resolvedPrompt };
 }
 
-// src/generation/batch.ts
-function createBatchResolver(options) {
-  const maxBatch = Math.max(1, Math.floor(options.maxBatch ?? 50));
-  const delayMs = Math.max(0, options.delayMs ?? 0);
-  const settled = /* @__PURE__ */ new Map();
-  const failures = /* @__PURE__ */ new Set();
-  const inFlight = /* @__PURE__ */ new Map();
-  let queue = [];
-  let timer = null;
-  const run = (keys) => {
-    const pendings = keys.map((key) => inFlight.get(key));
-    const finish = (values, error) => {
-      if (values === null) options.onError?.(error, keys);
-      keys.forEach((key, index) => {
-        const pending = pendings[index];
-        const value = values?.get(key);
-        if (pending && inFlight.get(key) === pending) {
-          inFlight.delete(key);
-          settled.set(key, value);
-          if (values === null) failures.add(key);
-        }
-        pending?.resolve(value);
-      });
-    };
-    let promise;
-    try {
-      promise = Promise.resolve(options.fetch(keys));
-    } catch (error) {
-      promise = Promise.reject(error);
-    }
-    promise.then(
-      (values) => finish(values instanceof Map ? values : /* @__PURE__ */ new Map()),
-      (error) => finish(null, error ?? new Error("Batch fetch failed."))
-    );
-  };
-  const flush = () => {
-    if (timer !== null) clearTimeout(timer);
-    timer = null;
-    const keys = queue;
-    queue = [];
-    for (let i = 0; i < keys.length; i += maxBatch) run(keys.slice(i, i + maxBatch));
-  };
-  const load = (key) => {
-    if (settled.has(key)) return Promise.resolve(settled.get(key));
-    const existing = inFlight.get(key);
-    if (existing) return existing.promise;
-    let resolve;
-    const promise = new Promise((r) => resolve = r);
-    inFlight.set(key, { promise, resolve });
-    queue.push(key);
-    if (queue.length >= maxBatch) flush();
-    else if (timer === null) timer = setTimeout(flush, delayMs);
-    return promise;
-  };
-  return {
-    load,
-    loadMany: (keys) => Promise.all(keys.map(load)),
-    peek: (key) => settled.get(key),
-    has: (key) => settled.has(key),
-    failed: (key) => failures.has(key),
-    prime(key, value) {
-      settled.set(key, value);
-      failures.delete(key);
-    },
-    clear(key) {
-      if (key === void 0) {
-        settled.clear();
-        failures.clear();
-        for (const k of [...inFlight.keys()]) if (!queue.includes(k)) inFlight.delete(k);
-        return;
-      }
-      settled.delete(key);
-      failures.delete(key);
-      if (!queue.includes(key)) inFlight.delete(key);
-    },
-    flush
-  };
+// src/generation/record.ts
+var GENERATION_RECORD_FORMAT = "pixerate.generation-record";
+var GENERATION_RECORD_VERSION = 1;
+var idCounter = 0;
+function createGenerationRecordId() {
+  const uuid = globalThis.crypto?.randomUUID?.();
+  if (typeof uuid === "string") return `gen_${uuid}`;
+  idCounter = (idCounter + 1) % 1679616;
+  const random = Math.floor(Math.random() * 2 ** 48).toString(36).padStart(10, "0");
+  return `gen_${Date.now().toString(36)}${idCounter.toString(36).padStart(4, "0")}${random}`;
 }
-
-// src/generation/progress.ts
-var MAX_PENDING_PERCENT = 95;
-var ALMOST_DONE_MS = 5e3;
-var UNKNOWN_DURATION_TAU_MS = 3e4;
-var toMs = (value) => typeof value === "number" ? value : new Date(value).getTime();
-function formatRemaining(ms) {
-  const seconds = Math.ceil(ms / 1e3);
-  if (seconds < 60) return `~${Math.max(1, seconds)}s left`;
-  const minutes = Math.ceil(ms / 6e4);
-  if (minutes < 60) return `~${minutes}m left`;
-  const hours = Math.floor(minutes / 60);
-  const rest = minutes % 60;
-  return rest ? `~${hours}h ${rest}m left` : `~${hours}h left`;
+var clone2 = (value) => value === void 0 ? value : JSON.parse(JSON.stringify(value));
+function recordTemplates(pinned) {
+  return pinned.map((p) => ({
+    name: p.name,
+    ...p.templateId !== void 0 ? { templateId: p.templateId } : {},
+    ...p.versionId !== void 0 ? { versionId: p.versionId, version: p.version } : {},
+    hash: hashText(p.body)
+  }));
 }
-function estimateJobProgress(input) {
-  const started = toMs(input.startedAt);
-  const now = toMs(input.now ?? Date.now());
-  const elapsedMs = Math.max(0, now - started);
-  if (input.done) return { percent: 100, label: "Done", elapsedMs, remainingMs: 0, overdue: false };
-  if (!Number.isFinite(started) || now <= started) {
-    return { percent: 0, label: "Starting\u2026", elapsedMs: 0, ...input.expectedMs ? { remainingMs: input.expectedMs } : {}, overdue: false };
-  }
-  const expected = input.expectedMs;
-  if (!expected || !(expected > 0)) {
-    const percent2 = MAX_PENDING_PERCENT * (1 - Math.exp(-elapsedMs / UNKNOWN_DURATION_TAU_MS));
-    return { percent: Math.floor(percent2), label: "Working\u2026", elapsedMs, overdue: false };
+function recordAssets(references, lookup) {
+  const resolve = toAssetResolver(lookup);
+  return (references ?? []).map((ref) => {
+    const info = resolve?.(ref.id);
+    const contentHash = ref.contentHash ?? info?.contentHash;
+    const mediaType = ref.mediaType ?? info?.mediaType;
+    const url = ref.url ?? info?.url;
+    return {
+      id: ref.id,
+      role: ref.role,
+      ...contentHash !== void 0 ? { contentHash } : {},
+      ...mediaType !== void 0 ? { mediaType } : {},
+      ...url !== void 0 ? { url } : {}
+    };
+  });
+}
+function createGenerationRecord(options) {
+  const {
+    model,
+    request: settingsInput,
+    plan: planInput,
+    strategy: strategyInput,
+    mentions,
+    assets,
+    seed: seedInput,
+    id,
+    parentId,
+    kind,
+    ...provenanceOptions
+  } = options;
+  const caps = typeof model === "string" ? void 0 : model;
+  const settings = clone2(settingsInput ?? planInput?.request ?? {});
+  let plan = planInput;
+  if (!plan && caps) {
+    const resolved = resolvePrompt(options.rawPrompt, options.templates ?? [], {
+      bindings: options.bindings,
+      values: options.values,
+      maxDepth: options.maxDepth
+    });
+    plan = planGenerationRequest(settings, caps, {
+      strategy: strategyInput ?? "nearest",
+      resolvedPrompt: resolved.text,
+      ...mentions ? { mentions } : {}
+    });
   }
-  const remainingMs = Math.max(0, expected - elapsedMs);
-  const percent = Math.min(MAX_PENDING_PERCENT, Math.floor(elapsedMs / expected * 100));
+  const provenance = createProvenance({
+    ...provenanceOptions,
+    model,
+    ...plan ? { plan } : { request: settings }
+  });
+  const seed = seedInput ?? provenance.request.seed;
   return {
-    percent,
-    label: remainingMs <= ALMOST_DONE_MS ? "Almost done\u2026" : formatRemaining(remainingMs),
-    elapsedMs,
-    remainingMs,
-    overdue: elapsedMs > expected
+    format: GENERATION_RECORD_FORMAT,
+    version: GENERATION_RECORD_VERSION,
+    id: id ?? createGenerationRecordId(),
+    ...parentId !== void 0 ? { parentId } : {},
+    kind: kind ?? (parentId !== void 0 ? "recreate" : "generate"),
+    provenance,
+    templates: recordTemplates(provenance.templates),
+    promptHash: hashText(provenance.resolvedPrompt),
+    ...caps ? { capabilityHash: hashCapabilities(caps) } : {},
+    settings,
+    strategy: strategyInput ?? plan?.strategy ?? "nearest",
+    ...seed !== void 0 ? { seed } : {},
+    assets: recordAssets(provenance.request.references, assets),
+    ...mentions?.length ? { mentions: clone2([...mentions]) } : {},
+    createdAt: provenance.createdAt
   };
 }
-function expectedDurationFor(caps, request = {}) {
-  const timing = caps.timing;
-  if (!timing) return void 0;
-  const count = request.count ?? caps.count?.default ?? 1;
-  const duration = request.duration ?? caps.duration?.default ?? 0;
-  const resolution = request.resolution ?? caps.resolutions?.default;
-  const megapixels = resolution ? resolutionMegapixels(resolution) ?? 0 : 0;
-  return Math.round(
-    timing.baseMs + (timing.perItemMs ?? 0) * Math.max(0, count - 1) + (timing.perSecondMs ?? 0) * duration + (timing.perMegapixelMs ?? 0) * megapixels
-  );
+function completeGenerationRecord(record, update) {
+  const next = clone2(record);
+  const now = new Date(update.completedAt ?? Date.now()).toISOString();
+  if (update.outputIds) next.provenance.outputIds = [...update.outputIds];
+  next.provenance.completedAt = now;
+  if (update.meta) next.provenance.meta = { ...next.provenance.meta ?? {}, ...clone2(update.meta) };
+  if (update.seed !== void 0) next.seed = update.seed;
+  next.updatedAt = now;
+  return next;
 }
-
-// src/generation/controls.ts
-function enumControl(key, label, cap) {
-  if (!cap?.options.length) return null;
-  return {
-    key,
-    label,
-    kind: "select",
-    valueType: "string",
-    options: cap.options.map((value) => ({ value, label: cap.labels?.[value] ?? value })),
-    ...cap.default !== void 0 ? { defaultValue: cap.default } : {}
-  };
+function serializeGenerationRecord(record) {
+  return JSON.stringify(record);
 }
-function getGenerationControls(caps) {
-  const controls = [];
-  const modes = supportedModes(caps);
-  if (modes.length > 1) {
-    controls.push({
-      key: "mode",
-      label: "Mode",
-      kind: "select",
-      valueType: "string",
-      options: modes.map((m) => ({ value: m, label: m[0].toUpperCase() + m.slice(1) })),
-      defaultValue: "generate"
-    });
+var isObject = (value) => !!value && typeof value === "object" && !Array.isArray(value);
+function parseGenerationRecord(input) {
+  let data = input;
+  if (typeof input === "string") {
+    try {
+      data = JSON.parse(input);
+    } catch {
+      throw new ProvenanceParseError("Generation record is not valid JSON.");
+    }
   }
-  const negative = textFieldCapability(caps.negativePrompt);
-  if (negative) controls.push({ key: "negativePrompt", label: "Negative prompt", kind: "textarea", valueType: "string", maxLength: negative.maxLength });
-  const system = textFieldCapability(caps.systemPrompt);
-  if (system) controls.push({ key: "systemPrompt", label: "System prompt", kind: "textarea", valueType: "string", maxLength: system.maxLength });
-  controls.push(enumControl("aspectRatio", "Aspect ratio", caps.aspectRatios));
-  controls.push(enumControl("resolution", "Resolution", caps.resolutions));
-  controls.push(enumControl("quality", "Quality", caps.quality));
-  if (caps.count) {
-    const options = caps.count.options?.filter((o) => o >= 1 && o <= caps.count.max);
-    controls.push(
-      options?.length ? { key: "count", label: "Outputs", kind: "select", valueType: "number", options: options.map((o) => ({ value: o, label: String(o) })), defaultValue: caps.count.default } : { key: "count", label: "Outputs", kind: "range", valueType: "number", min: 1, max: caps.count.max, step: 1, defaultValue: caps.count.default ?? 1 }
-    );
+  if (!isObject(data) || data.format !== GENERATION_RECORD_FORMAT) {
+    throw new ProvenanceParseError("Not a generation record.");
   }
-  if (caps.duration) {
-    const d = caps.duration;
-    const options = d.options?.filter((o) => (d.min === void 0 || o >= d.min) && (d.max === void 0 || o <= d.max));
-    controls.push(
-      options?.length ? { key: "duration", label: "Duration (s)", kind: "select", valueType: "number", options: options.map((o) => ({ value: o, label: `${o}s` })), defaultValue: d.default } : {
-        key: "duration",
-        label: "Duration (s)",
-        kind: d.min !== void 0 && d.max !== void 0 ? "range" : "number",
-        valueType: "number",
-        min: d.min,
-        max: d.max,
-        step: d.step,
-        defaultValue: d.default
-      }
-    );
+  if (typeof data.version !== "number" || data.version > GENERATION_RECORD_VERSION) {
+    throw new ProvenanceParseError(`Unsupported generation record version ${JSON.stringify(data.version)}.`);
   }
-  const seed = seedCapability(caps.seed);
-  if (seed) controls.push({ key: "seed", label: "Seed", kind: "number", valueType: "number", min: seed.min, max: seed.max, step: 1 });
-  for (const [name, spec] of Object.entries(caps.params ?? {})) {
-    const base = { key: `params.${name}`, label: spec.label ?? name, ...spec.description ? { description: spec.description } : {} };
-    if (spec.type === "boolean") {
-      controls.push({ ...base, kind: "checkbox", valueType: "boolean", defaultValue: spec.default });
-    } else if (spec.type === "enum") {
-      const numeric = spec.options.every((o) => typeof o === "number");
-      controls.push({
-        ...base,
-        kind: "select",
-        valueType: numeric ? "number" : "string",
-        options: spec.options.map((value) => ({ value, label: String(value) })),
-        defaultValue: spec.default
-      });
-    } else {
-      controls.push({
-        ...base,
-        kind: spec.min !== void 0 && spec.max !== void 0 ? "range" : "number",
-        valueType: "number",
-        min: spec.min,
-        max: spec.max,
-        step: spec.step ?? (spec.type === "integer" ? 1 : void 0),
-        defaultValue: spec.default
+  const checks = [
+    ["id", typeof data.id === "string" && data.id !== ""],
+    ["templates", Array.isArray(data.templates) && data.templates.every((t) => isObject(t) && typeof t.name === "string" && typeof t.hash === "string")],
+    ["assets", Array.isArray(data.assets) && data.assets.every((a) => isObject(a) && typeof a.id === "string" && typeof a.role === "string")],
+    ["settings", isObject(data.settings)],
+    ["promptHash", typeof data.promptHash === "string"],
+    ["createdAt", typeof data.createdAt === "string"]
+  ];
+  const bad = checks.find(([, ok]) => !ok);
+  if (bad) throw new ProvenanceParseError(`Invalid generation record field "${bad[0]}".`);
+  const provenance = parseProvenance(data.provenance);
+  return {
+    ...data,
+    kind: data.kind === "recreate" || data.kind === "variation" ? data.kind : "generate",
+    strategy: ["nearest", "upgrade", "downgrade", "error"].includes(data.strategy) ? data.strategy : "nearest",
+    provenance
+  };
+}
+function isGenerationRecord(value) {
+  return isObject(value) && value.format === GENERATION_RECORD_FORMAT;
+}
+var SKIPPED_SETTING_FIELDS = /* @__PURE__ */ new Set(["model", "prompt", "references", "params", "seed"]);
+function findModel(capabilities, modelId) {
+  if (!capabilities) return { given: false };
+  const list2 = Array.isArray(capabilities) ? capabilities : [capabilities];
+  return { given: true, caps: list2.find((m) => m.id === modelId) };
+}
+var sameValue = (a, b) => stableStringify(a) === stableStringify(b);
+var show = (value) => value === void 0 ? "unset" : typeof value === "string" ? `"${value}"` : JSON.stringify(value);
+var refKey = (ref) => `${ref.role}:${ref.id}`;
+function templateDrift(record, current, mode) {
+  if (!current) return [];
+  const byName = new Map(current.map((t) => [t.name, t]));
+  const drift = [];
+  for (const recorded of record.templates) {
+    const template = byName.get(recorded.name);
+    const fromVersion = recorded.version ?? recorded.versionId;
+    if (!template) {
+      drift.push({
+        type: "template-missing",
+        severity: "warning",
+        template: recorded.name,
+        from: fromVersion,
+        applied: false,
+        message: `Template "${recorded.name}" no longer exists; the recorded body is used.`
       });
+      continue;
     }
+    const body = getTemplateBody(template, {});
+    const hash = body === void 0 ? void 0 : hashText(body);
+    if (hash === recorded.hash) continue;
+    const latest = getLatestVersion(template);
+    const toVersion = template.versions?.length ? latest?.version ?? latest?.id : void 0;
+    const versions = fromVersion !== void 0 || toVersion !== void 0 ? ` (${fromVersion ?? "unversioned"} \u2192 ${toVersion ?? "unversioned"})` : "";
+    drift.push({
+      type: "template-changed",
+      severity: mode === "latest" ? "info" : "warning",
+      template: recorded.name,
+      from: { version: fromVersion, hash: recorded.hash },
+      to: { version: toVersion, hash },
+      applied: mode === "latest",
+      message: mode === "latest" ? `Template "${recorded.name}" changed since this generation${versions}; using the current version.` : `Template "${recorded.name}" changed since this generation${versions}; recreating with the recorded version.`
+    });
   }
-  return controls.filter((c) => c !== null);
+  return drift;
 }
-function getRequestValue(request, key) {
-  if (key.startsWith("params.")) return request.params?.[key.slice(7)];
-  return request[key];
-}
-function setRequestValue(request, key, value) {
-  const remove = value === void 0 || value === "" || typeof value === "number" && Number.isNaN(value);
-  if (key.startsWith("params.")) {
-    const name = key.slice(7);
-    const params = { ...request.params ?? {} };
-    if (remove) delete params[name];
-    else params[name] = value;
-    const next2 = { ...request, params };
-    if (Object.keys(params).length === 0) delete next2.params;
-    return next2;
+function randomSeed(caps, previous, random) {
+  const cap = caps ? seedCapability(caps.seed) : {};
+  if (!cap) return void 0;
+  const min = Math.ceil(cap.min ?? 0);
+  const max = Math.floor(cap.max ?? 2 ** 31 - 1);
+  if (max < min) return min;
+  let seed = previous;
+  for (let attempt = 0; attempt < 8 && (seed === void 0 || seed === previous); attempt++) {
+    seed = min + Math.floor(random() * (max - min + 1));
   }
-  const next = { ...request };
-  if (remove) delete next[key];
-  else next[key] = value;
-  return next;
+  if (seed === previous && max > min) seed = previous === max ? min : previous + 1;
+  return seed;
 }
-function parseControlValue(control, raw) {
-  if (control.valueType === "boolean") return Boolean(raw);
-  if (raw === "" || raw === void 0) return void 0;
-  if (control.valueType === "number") {
-    const n = Number(raw);
-    return Number.isFinite(n) ? n : void 0;
+function rebuild(record, options, kind, overrides) {
+  const mode = options.mode ?? "exact";
+  const provenance = record.provenance;
+  const drift = templateDrift(record, options.templates, mode);
+  const rawPrompt = overrides?.rawPrompt ?? provenance.rawPrompt;
+  const values = overrides?.values !== void 0 ? { ...provenance.values ?? {}, ...overrides.values } : provenance.values ? clone2(provenance.values) : null;
+  const pinned = pinnedTemplatesToTemplates(provenance.templates);
+  let templates;
+  let bindings;
+  if (mode === "latest" && options.templates) {
+    const currentNames = new Set(options.templates.map((t) => t.name));
+    const fallback = pinned.filter((t) => !currentNames.has(t.name));
+    templates = [...options.templates.map((t) => ({ ...t })), ...fallback];
+    bindings = {};
+    for (const t of fallback) {
+      if (provenance.bindings[t.name] !== void 0) bindings[t.name] = provenance.bindings[t.name];
+    }
+  } else {
+    templates = pinned;
+    bindings = { ...provenance.bindings };
   }
-  return String(raw);
-}
-function getReferenceSlots(caps, request = {}) {
-  const roles = supportedReferenceRoles(caps);
-  if (caps.inpainting && !roles.includes("mask")) roles.push("mask");
-  const refs = request.references ?? [];
-  const total = refs.length;
-  const maxTotal = caps.references?.maxTotal ?? Infinity;
-  return roles.map((role) => {
-    const cap = caps.references?.roles[role] ?? { max: 1 };
-    const references = refs.filter((ref) => ref.role === role);
-    return {
-      role,
-      label: referenceRoleLabel(role, caps),
-      ...cap.description ? { description: cap.description } : {},
-      ..."accepts" in cap && cap.accepts?.length ? { accepts: [...cap.accepts] } : {},
-      min: cap.min ?? 0,
-      max: cap.max,
-      references,
-      canAdd: references.length < cap.max && total < maxTotal
-    };
-  });
-}
-function addReference(request, reference) {
-  return { ...request, references: [...request.references ?? [], { ...reference }] };
-}
-function removeReference(request, role, id) {
-  const references = (request.references ?? []).filter((ref) => !(ref.role === role && ref.id === id));
-  const next = { ...request, references };
-  if (references.length === 0) delete next.references;
-  return next;
-}
-
-// src/generation/assets.ts
-function toAssetResolver(lookup) {
-  if (!lookup) return void 0;
-  if (typeof lookup === "function") return (id) => lookup(id) ?? void 0;
-  if (lookup instanceof Map) return (id) => lookup.get(id);
-  const byId = new Map(lookup.map((asset) => [asset.id, asset]));
-  return (id) => byId.get(id);
-}
-function roleCap(caps, role) {
-  const cap = caps.references?.roles[role];
-  if (cap && cap.max > 0) return cap;
-  if (role === "mask" && caps.inpainting) return { max: 1 };
-  return void 0;
-}
-function getAssetRoleOptions(caps) {
-  const roles = supportedReferenceRoles(caps);
-  if (caps.inpainting && !roles.includes("mask")) roles.push("mask");
-  return roles.map((role) => {
-    const cap = roleCap(caps, role) ?? { max: 1 };
-    return {
-      role,
-      label: referenceRoleLabel(role, caps),
-      ...cap.description ? { description: cap.description } : {},
-      min: cap.min ?? 0,
-      max: cap.max,
-      ...cap.accepts?.length ? { accepts: [...cap.accepts] } : {}
-    };
+  const resolved = resolvePrompt(rawPrompt, templates, { bindings, ...values ? { values } : {} });
+  const sourceMap = resolved.map.map((segment) => {
+    const { locked: _locked, ...rest } = segment;
+    return rest;
   });
-}
-function validateAssetMentions(mentions, caps, options = {}) {
-  const resolve = toAssetResolver(options.assets);
-  const issues = [];
-  const counts = {};
-  mentions.forEach((mention, index) => {
-    const id = mention.id;
-    const label = `@${mention.label ?? id}`;
-    if (!mention.role) {
-      issues.push({ index, id, code: "missing-role", severity: "warning", message: `${label} has no role.` });
-      return;
+  if (resolved.text !== provenance.resolvedPrompt && !overrides) {
+    drift.push({
+      type: "prompt-changed",
+      severity: "info",
+      from: provenance.resolvedPrompt,
+      to: resolved.text,
+      applied: true,
+      message: "The resolved prompt differs from the recorded one."
+    });
+  }
+  const base = clone2(mode === "exact" ? provenance.request : record.settings);
+  const recordedPlanned = provenance.request;
+  if (base.prompt === void 0 || base.prompt === provenance.resolvedPrompt) base.prompt = resolved.text;
+  else if (base.prompt === provenance.rawPrompt) base.prompt = rawPrompt;
+  if (mode === "latest" && record.mentions?.length) {
+    const plannedRole = new Map((recordedPlanned.references ?? []).map((ref) => [ref.id, ref.role]));
+    base.references = [
+      ...base.references ?? [],
+      ...record.mentions.map((m) => ({
+        id: m.id,
+        role: m.role || plannedRole.get(m.id) || "image_ref",
+        ...m.url !== void 0 ? { url: m.url } : {},
+        ...m.mediaType !== void 0 ? { mediaType: m.mediaType } : {},
+        ...m.contentHash !== void 0 ? { contentHash: m.contentHash } : {}
+      }))
+    ];
+  } else if (mode === "latest" && base.references === void 0 && recordedPlanned.references) {
+    base.references = clone2(recordedPlanned.references);
+  }
+  if (record.seed !== void 0) base.seed = record.seed;
+  base.model = provenance.modelId;
+  const { given, caps } = findModel(options.capabilities, provenance.modelId);
+  if (overrides) {
+    if (overrides.settings) {
+      const { params, ...rest } = overrides.settings;
+      Object.assign(base, clone2(rest));
+      if (params) base.params = { ...base.params ?? {}, ...clone2(params) };
     }
-    let role = mention.role;
-    if (!roleCap(caps, role)) {
-      const alias = normalizeReferenceRole(role, caps);
-      if (alias !== role && roleCap(caps, alias)) {
-        issues.push({
-          index,
-          id,
-          role,
-          code: "renamed-role",
-          severity: "warning",
-          suggestion: alias,
-          message: `${label}: this model calls "${role}" ${referenceRoleLabel(alias, caps)} (${alias}).`
-        });
-        role = alias;
-      } else {
-        issues.push({
-          index,
-          id,
-          role,
-          code: "unsupported-role",
+    if (overrides.seed === null) delete base.seed;
+    else base.seed = overrides.seed ?? randomSeed(caps, record.seed, overrides.random ?? Math.random);
+    if (base.seed === void 0) delete base.seed;
+  }
+  const resolveAsset = toAssetResolver(options.assets);
+  if (resolveAsset && base.references) {
+    const recordedById = new Map(record.assets.map((a) => [refKey(a), a]));
+    const kept = [];
+    for (const ref of base.references) {
+      const info = resolveAsset(ref.id);
+      if (!info) {
+        drift.push({
+          type: "asset-missing",
           severity: "error",
-          message: `${label}: ${caps.name ?? caps.id} does not accept ${referenceRoleLabel(role, caps).toLowerCase()} assets.`
+          assetId: ref.id,
+          role: ref.role,
+          message: `Asset "${ref.id}" (${ref.role}) is no longer available.`
+        });
+        continue;
+      }
+      const recordedHash = recordedById.get(refKey(ref))?.contentHash ?? ref.contentHash;
+      if (recordedHash !== void 0 && info.contentHash !== void 0 && recordedHash !== info.contentHash) {
+        drift.push({
+          type: "asset-changed",
+          severity: "warning",
+          assetId: ref.id,
+          role: ref.role,
+          from: recordedHash,
+          to: info.contentHash,
+          applied: true,
+          message: `Asset "${ref.id}" (${ref.role}) has changed since this generation.`
         });
-        return;
       }
+      const next = { ...ref };
+      if (info.contentHash !== void 0) next.contentHash = info.contentHash;
+      if (next.mediaType === void 0 && info.mediaType !== void 0) next.mediaType = info.mediaType;
+      kept.push(next);
     }
-    const cap = roleCap(caps, role);
-    const mediaType = mention.mediaType ?? resolve?.(id)?.mediaType;
-    if (mediaType !== void 0 && !mediaTypeMatches(mediaType, cap.accepts)) {
-      issues.push({
-        index,
-        id,
-        role,
-        code: "media-mismatch",
-        severity: "error",
-        message: `${label} is ${mediaType}; ${referenceRoleLabel(role, caps)} accepts ${(cap.accepts ?? []).join(", ")}.`
+    if (kept.length) base.references = kept;
+    else delete base.references;
+  }
+  let plan;
+  let request = base;
+  if (given && !caps) {
+    drift.push({
+      type: "model-missing",
+      severity: "error",
+      modelId: provenance.modelId,
+      message: `Model "${provenance.modelId}" is no longer available.`
+    });
+  } else if (caps) {
+    const capabilityHash = hashCapabilities(caps);
+    if (record.capabilityHash !== void 0 && record.capabilityHash !== capabilityHash) {
+      drift.push({
+        type: "model-changed",
+        severity: "warning",
+        modelId: caps.id,
+        from: record.capabilityHash,
+        to: capabilityHash,
+        message: `The capabilities of "${caps.name ?? caps.id}" changed since this generation.`
       });
-      return;
     }
-    counts[role] = (counts[role] ?? 0) + 1;
-    if (counts[role] > cap.max) {
-      issues.push({
-        index,
-        id,
-        role,
-        code: "too-many",
-        severity: "warning",
-        message: `${label}: at most ${cap.max} ${referenceRoleLabel(role, caps).toLowerCase()} asset(s); extra ones are left out.`
+    plan = planGenerationRequest(base, caps, {
+      strategy: options.strategy ?? record.strategy,
+      resolvedPrompt: resolved.text
+    });
+    request = plan.request;
+    const severity = mode === "exact" && !overrides ? "warning" : "info";
+    const type = mode === "exact" && !overrides ? "setting-unsupported" : "setting-changed";
+    const describeChange = (field, from, to) => {
+      const adjustment = plan.adjustments.find((a) => a.field === field || a.field.startsWith(`${field}.`));
+      drift.push({
+        type,
+        severity,
+        field,
+        from,
+        to,
+        applied: true,
+        message: type === "setting-unsupported" ? `${field} ${show(from)} is no longer supported; using ${show(to)}.${adjustment ? ` ${adjustment.reason}` : ""}` : `${field} was ${show(from)}, now ${show(to)}.${adjustment ? ` ${adjustment.reason}` : ""}`
+      });
+    };
+    if (!overrides) {
+      for (const field of GENERATION_REQUEST_FIELDS) {
+        if (SKIPPED_SETTING_FIELDS.has(field)) continue;
+        const from = recordedPlanned[field];
+        const to = request[field];
+        if (!sameValue(from, to)) describeChange(field, from, to);
+      }
+      const paramNames = /* @__PURE__ */ new Set([...Object.keys(recordedPlanned.params ?? {}), ...Object.keys(request.params ?? {})]);
+      for (const name of [...paramNames].sort()) {
+        const from = recordedPlanned.params?.[name];
+        const to = request.params?.[name];
+        if (!sameValue(from, to)) describeChange(`params.${name}`, from, to);
+      }
+      if (!sameValue(record.seed ?? recordedPlanned.seed, request.seed)) describeChange("seed", record.seed ?? recordedPlanned.seed, request.seed);
+      const missing = new Set(drift.filter((d) => d.type === "asset-missing").map((d) => `${d.role}:${d.assetId}`));
+      const fromRefs = (recordedPlanned.references ?? []).map(refKey).filter((key) => !missing.has(key));
+      const toRefs = (request.references ?? []).map(refKey);
+      if (!sameValue(fromRefs, toRefs)) describeChange("references", fromRefs, toRefs);
+    }
+    for (const error of plan.errors) {
+      drift.push({
+        type: "setting-unsupported",
+        severity: "error",
+        field: error.field,
+        from: error.value,
+        message: error.message
       });
     }
-  });
-  const missing = getAssetRoleOptions(caps).filter((option) => (counts[option.role] ?? 0) < option.min).map((option) => ({ role: option.role, min: option.min, count: counts[option.role] ?? 0 }));
-  return { ok: !issues.some((issue) => issue.severity === "error") && missing.length === 0, issues, counts, missing };
-}
-function resolveAssetMentions(mentions, assets) {
-  const byId = new Map(assets.map((asset) => [asset.id, asset]));
-  const byLabel = new Map(assets.filter((a) => a.label).map((asset) => [asset.label.toLowerCase(), asset]));
-  const result = [];
-  for (const mention of mentions) {
-    const asset = byId.get(mention.handle) ?? byLabel.get(mention.handle.toLowerCase());
-    if (!asset) continue;
-    result.push({
-      id: asset.id,
-      label: mention.handle,
-      ...mention.role ? { role: mention.role } : {},
-      ...asset.mediaType !== void 0 ? { mediaType: asset.mediaType } : {},
-      ...asset.contentHash !== void 0 ? { contentHash: asset.contentHash } : {},
-      ...asset.url !== void 0 ? { url: asset.url } : {}
-    });
   }
-  return result;
-}
-function defaultAssetRoleOptions() {
-  return REFERENCE_ROLES.map((role) => ({ role, label: referenceRoleLabel(role), min: 0, max: 1 }));
+  const ok = !drift.some((d) => d.severity === "error") && (plan ? plan.ok : true);
+  const recordOptions = {
+    rawPrompt,
+    templates,
+    bindings,
+    ...values ? { values } : {},
+    model: caps ?? provenance.modelId,
+    request,
+    ...plan ? { plan } : {},
+    strategy: options.strategy ?? record.strategy,
+    parentId: record.id,
+    kind
+  };
+  return {
+    mode,
+    ok,
+    request,
+    ...plan ? { plan } : {},
+    rawPrompt,
+    resolvedPrompt: resolved.text,
+    sourceMap,
+    values,
+    templates,
+    bindings,
+    drift,
+    parentId: record.id,
+    kind,
+    recordOptions
+  };
 }
-function describeAssetMentions(mentions, assets, caps) {
-  const byId = new Map(assets.map((asset) => [asset.id, asset]));
-  const byLabel = new Map(assets.filter((a) => a.label).map((asset) => [asset.label.toLowerCase(), asset]));
-  const chips = [];
-  for (const mention of mentions) {
-    const asset = byId.get(mention.handle) ?? byLabel.get(mention.handle.toLowerCase());
-    if (!asset) continue;
-    const role = mention.role || void 0;
-    chips.push({
-      index: chips.length,
-      ...mention.start !== void 0 ? { start: mention.start } : {},
-      handle: mention.handle,
-      asset,
-      ...role ? { role, roleLabel: referenceRoleLabel(caps ? normalizeReferenceRole(role, caps) : role, caps) } : {},
-      issues: []
-    });
-  }
-  if (caps) {
-    const validation = validateAssetMentions(
-      chips.map((chip) => ({
-        id: chip.asset.id,
-        label: chip.handle,
-        ...chip.role ? { role: chip.role } : {},
-        ...chip.asset.mediaType ? { mediaType: chip.asset.mediaType } : {}
-      })),
-      caps
-    );
-    for (const issue of validation.issues) chips[issue.index].issues.push(issue);
-  }
-  return chips;
+function recreateRequest(input, options) {
+  if (isGenerationRecord(input)) return rebuild(input, options ?? {}, "recreate");
+  const provenance = input;
+  const request = clone2(provenance.request);
+  request.model = provenance.modelId;
+  if (request.prompt === void 0) request.prompt = provenance.resolvedPrompt;
+  return request;
 }
-
-// src/generation/record.ts
-var GENERATION_RECORD_FORMAT = "pixerate.generation-record";
-var GENERATION_RECORD_VERSION = 1;
-var idCounter = 0;
-function createGenerationRecordId() {
-  const uuid = globalThis.crypto?.randomUUID?.();
-  if (typeof uuid === "string") return `gen_${uuid}`;
-  idCounter = (idCounter + 1) % 1679616;
-  const random = Math.floor(Math.random() * 2 ** 48).toString(36).padStart(10, "0");
-  return `gen_${Date.now().toString(36)}${idCounter.toString(36).padStart(4, "0")}${random}`;
+function variationRequest(record, overrides = {}, options = {}) {
+  return rebuild(record, options, "variation", overrides);
 }
-var clone2 = (value) => value === void 0 ? value : JSON.parse(JSON.stringify(value));
-function recordTemplates(pinned) {
-  return pinned.map((p) => ({
-    name: p.name,
-    ...p.templateId !== void 0 ? { templateId: p.templateId } : {},
-    ...p.versionId !== void 0 ? { versionId: p.versionId, version: p.version } : {},
-    hash: hashText(p.body)
-  }));
+var DRIFT_TYPE_LABELS = {
+  "template-changed": "Template changed",
+  "template-missing": "Template deleted",
+  "prompt-changed": "Prompt changed",
+  "model-missing": "Model unavailable",
+  "model-changed": "Model changed",
+  "setting-unsupported": "Setting unsupported",
+  "setting-changed": "Setting changed",
+  "asset-missing": "Asset missing",
+  "asset-changed": "Asset changed"
+};
+function blockingDrift(drift) {
+  return drift.filter((d) => d.severity === "error");
 }
-function recordAssets(references, lookup) {
-  const resolve = toAssetResolver(lookup);
-  return (references ?? []).map((ref) => {
-    const info = resolve?.(ref.id);
-    const contentHash = ref.contentHash ?? info?.contentHash;
-    const mediaType = ref.mediaType ?? info?.mediaType;
-    const url = ref.url ?? info?.url;
-    return {
-      id: ref.id,
-      role: ref.role,
-      ...contentHash !== void 0 ? { contentHash } : {},
-      ...mediaType !== void 0 ? { mediaType } : {},
-      ...url !== void 0 ? { url } : {}
-    };
-  });
+
+// src/generation/history-tools.ts
+var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
+var RECORD_ID = { type: "string", minLength: 1, description: "Generation record id from list_generations." };
+var read = (value) => typeof value === "function" ? value() : value;
+function forGenerate(request) {
+  const { model, ...rest } = request;
+  return { model, request: rest };
+}
+function rebuiltResult(result) {
+  return {
+    ok: result.ok,
+    parentId: result.parentId,
+    kind: result.kind,
+    mode: result.mode,
+    ...forGenerate(result.request),
+    resolvedPrompt: result.resolvedPrompt,
+    drift: result.drift.map(({ type, severity, message, field, template, assetId }) => ({
+      type,
+      severity,
+      message,
+      ...field !== void 0 ? { field } : {},
+      ...template !== void 0 ? { template } : {},
+      ...assetId !== void 0 ? { assetId } : {}
+    })),
+    ...result.plan ? { planErrors: result.plan.errors } : {}
+  };
 }
-function createGenerationRecord(options) {
-  const {
-    model,
-    request: settingsInput,
-    plan: planInput,
-    strategy: strategyInput,
-    mentions,
-    assets,
-    seed: seedInput,
-    id,
-    parentId,
-    kind,
-    ...provenanceOptions
-  } = options;
-  const caps = typeof model === "string" ? void 0 : model;
-  const settings = clone2(settingsInput ?? planInput?.request ?? {});
-  let plan = planInput;
-  if (!plan && caps) {
-    const resolved = resolvePrompt(options.rawPrompt, options.templates ?? [], {
-      bindings: options.bindings,
-      values: options.values,
-      maxDepth: options.maxDepth
-    });
-    plan = planGenerationRequest(settings, caps, {
-      strategy: strategyInput ?? "nearest",
-      resolvedPrompt: resolved.text,
-      ...mentions ? { mentions } : {}
-    });
-  }
-  const provenance = createProvenance({
-    ...provenanceOptions,
-    model,
-    ...plan ? { plan } : { request: settings }
+function createGenerationHistoryToolProvider(options) {
+  const { store } = options;
+  const recreateOptions = () => ({
+    capabilities: read(options.models),
+    templates: read(options.templates),
+    assets: options.assets
   });
-  const seed = seedInput ?? provenance.request.seed;
+  const recordOrThrow = async (id) => {
+    const record = await store.get(id);
+    if (!record) throw new Error(`Unknown generation "${id}". Call list_generations for record ids.`);
+    return record;
+  };
+  const listGenerations = {
+    name: "list_generations",
+    title: "List past generations",
+    description: "Lists recorded generations newest first: id, model, kind (generate, recreate, variation), parent id, time, templates, assets and the first 160 characters of the resolved prompt. Filter to find one to inspect, recreate or vary.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        model: { type: "string", description: "Only this model id." },
+        template: { type: "string", description: "Only records that used this template name or id." },
+        text: { type: "string", description: "Case-insensitive text in the prompt preview." },
+        kind: { type: "string", enum: ["generate", "recreate", "variation"], description: "Only this kind of record." },
+        parentId: { type: "string", description: "Only records recreated or varied from this record." },
+        limit: { type: "integer", minimum: 1, maximum: 100, description: "Most records to return (default 20)." },
+        offset: { type: "integer", minimum: 0, description: "Records to skip, for paging (default 0)." }
+      },
+      additionalProperties: false
+    },
+    annotations: { title: "List past generations", ...READ },
+    handler: async ({ limit = 20, offset = 0, ...filter }) => {
+      const all = await store.summaries(filter);
+      return { total: all.length, records: all.slice(offset, offset + limit) };
+    }
+  };
+  const getGeneration = {
+    name: "get_generation",
+    title: "Read a past generation",
+    description: "Returns one generation record: model, raw and resolved prompt, the settings as the user set them, the strategy, the seed used, the assets and templates it used, its parent and when it ran.",
+    inputSchema: { type: "object", properties: { id: RECORD_ID }, required: ["id"], additionalProperties: false },
+    annotations: { title: "Read a past generation", ...READ },
+    handler: async ({ id }) => {
+      const r = await recordOrThrow(id);
+      return {
+        id: r.id,
+        kind: r.kind,
+        ...r.parentId !== void 0 ? { parentId: r.parentId } : {},
+        createdAt: r.createdAt,
+        model: r.provenance.modelId,
+        rawPrompt: r.provenance.rawPrompt,
+        resolvedPrompt: r.provenance.resolvedPrompt,
+        settings: r.settings,
+        strategy: r.strategy,
+        ...r.seed !== void 0 ? { seed: r.seed } : {},
+        assets: r.assets,
+        templates: r.templates.map(({ name, templateId, version }) => ({ name, templateId, version }))
+      };
+    }
+  };
+  const recreate = {
+    name: "recreate_generation",
+    title: "Rebuild a past generation",
+    description: "Builds the request that reproduces a recorded generation, without running it. Returns `model` and `request` to pass to generate, `ok` (false when something blocks an exact reproduction), and drift: templates edited or deleted, the model changed or gone, settings no longer supported, assets missing or changed. Report drift to the user before generating.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: RECORD_ID,
+        mode: {
+          type: "string",
+          enum: ["exact", "latest"],
+          description: "exact (default) reproduces the recorded prompt and settings; latest uses the current templates and re-plans the settings for the current model."
+        }
+      },
+      required: ["id"],
+      additionalProperties: false
+    },
+    annotations: { title: "Rebuild a past generation", ...READ },
+    handler: async ({ id, mode }) => rebuiltResult(recreateRequest(await recordOrThrow(id), { ...recreateOptions(), mode }))
+  };
+  const vary = {
+    name: "vary_generation",
+    title: "Build a variation of a past generation",
+    description: "Builds a request for a variation of a recorded generation, without running it: the same prompt, settings and assets with a new seed (random unless given) and any changes. Returns `model` and `request` to pass to generate, plus drift.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: RECORD_ID,
+        seed: { type: ["integer", "null"], description: "Seed to use; null for none. Default: a random seed different from the record's." },
+        values: {
+          type: "object",
+          additionalProperties: { type: "string" },
+          description: 'Prompt variable values merged over the recorded ones, e.g. {"subject": "a red fox"}.'
+        },
+        settings: {
+          type: "object",
+          description: `Request settings merged over the recorded ones, e.g. {"aspectRatio": "16:9"} (params are merged too). See list_models for each model's fields.`
+        },
+        rawPrompt: { type: "string", description: "A different raw prompt (templates and variables are resolved as usual)." }
+      },
+      required: ["id"],
+      additionalProperties: false
+    },
+    annotations: { title: "Build a variation of a past generation", readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    handler: async ({ id, seed, values, settings, rawPrompt }) => rebuiltResult(variationRequest(await recordOrThrow(id), { seed, values, settings, rawPrompt }, recreateOptions()))
+  };
   return {
-    format: GENERATION_RECORD_FORMAT,
-    version: GENERATION_RECORD_VERSION,
-    id: id ?? createGenerationRecordId(),
-    ...parentId !== void 0 ? { parentId } : {},
-    kind: kind ?? (parentId !== void 0 ? "recreate" : "generate"),
-    provenance,
-    templates: recordTemplates(provenance.templates),
-    promptHash: hashText(provenance.resolvedPrompt),
-    ...caps ? { capabilityHash: hashCapabilities(caps) } : {},
-    settings,
-    strategy: strategyInput ?? plan?.strategy ?? "nearest",
-    ...seed !== void 0 ? { seed } : {},
-    assets: recordAssets(provenance.request.references, assets),
-    ...mentions?.length ? { mentions: clone2([...mentions]) } : {},
-    createdAt: provenance.createdAt
+    id: options.id ?? "generation-history",
+    namespace: options.namespace,
+    tools: [listGenerations, getGeneration, recreate, vary],
+    subscribe: (notify) => store.subscribe(notify)
+  };
+}
+
+// src/generation/batch.ts
+function createBatchResolver(options) {
+  const maxBatch = Math.max(1, Math.floor(options.maxBatch ?? 50));
+  const delayMs = Math.max(0, options.delayMs ?? 0);
+  const settled = /* @__PURE__ */ new Map();
+  const failures = /* @__PURE__ */ new Set();
+  const inFlight = /* @__PURE__ */ new Map();
+  let queue = [];
+  let timer = null;
+  const run = (keys) => {
+    const pendings = keys.map((key) => inFlight.get(key));
+    const finish = (values, error) => {
+      if (values === null) options.onError?.(error, keys);
+      keys.forEach((key, index) => {
+        const pending = pendings[index];
+        const value = values?.get(key);
+        if (pending && inFlight.get(key) === pending) {
+          inFlight.delete(key);
+          settled.set(key, value);
+          if (values === null) failures.add(key);
+        }
+        pending?.resolve(value);
+      });
+    };
+    let promise;
+    try {
+      promise = Promise.resolve(options.fetch(keys));
+    } catch (error) {
+      promise = Promise.reject(error);
+    }
+    promise.then(
+      (values) => finish(values instanceof Map ? values : /* @__PURE__ */ new Map()),
+      (error) => finish(null, error ?? new Error("Batch fetch failed."))
+    );
+  };
+  const flush = () => {
+    if (timer !== null) clearTimeout(timer);
+    timer = null;
+    const keys = queue;
+    queue = [];
+    for (let i = 0; i < keys.length; i += maxBatch) run(keys.slice(i, i + maxBatch));
+  };
+  const load = (key) => {
+    if (settled.has(key)) return Promise.resolve(settled.get(key));
+    const existing = inFlight.get(key);
+    if (existing) return existing.promise;
+    let resolve;
+    const promise = new Promise((r) => resolve = r);
+    inFlight.set(key, { promise, resolve });
+    queue.push(key);
+    if (queue.length >= maxBatch) flush();
+    else if (timer === null) timer = setTimeout(flush, delayMs);
+    return promise;
+  };
+  return {
+    load,
+    loadMany: (keys) => Promise.all(keys.map(load)),
+    peek: (key) => settled.get(key),
+    has: (key) => settled.has(key),
+    failed: (key) => failures.has(key),
+    prime(key, value) {
+      settled.set(key, value);
+      failures.delete(key);
+    },
+    clear(key) {
+      if (key === void 0) {
+        settled.clear();
+        failures.clear();
+        for (const k of [...inFlight.keys()]) if (!queue.includes(k)) inFlight.delete(k);
+        return;
+      }
+      settled.delete(key);
+      failures.delete(key);
+      if (!queue.includes(key)) inFlight.delete(key);
+    },
+    flush
   };
 }
-function completeGenerationRecord(record, update) {
-  const next = clone2(record);
-  const now = new Date(update.completedAt ?? Date.now()).toISOString();
-  if (update.outputIds) next.provenance.outputIds = [...update.outputIds];
-  next.provenance.completedAt = now;
-  if (update.meta) next.provenance.meta = { ...next.provenance.meta ?? {}, ...clone2(update.meta) };
-  if (update.seed !== void 0) next.seed = update.seed;
-  next.updatedAt = now;
-  return next;
-}
-function serializeGenerationRecord(record) {
-  return JSON.stringify(record);
+
+// src/generation/progress.ts
+var MAX_PENDING_PERCENT = 95;
+var ALMOST_DONE_MS = 5e3;
+var UNKNOWN_DURATION_TAU_MS = 3e4;
+var toMs = (value) => typeof value === "number" ? value : new Date(value).getTime();
+function formatRemaining(ms) {
+  const seconds = Math.ceil(ms / 1e3);
+  if (seconds < 60) return `~${Math.max(1, seconds)}s left`;
+  const minutes = Math.ceil(ms / 6e4);
+  if (minutes < 60) return `~${minutes}m left`;
+  const hours = Math.floor(minutes / 60);
+  const rest = minutes % 60;
+  return rest ? `~${hours}h ${rest}m left` : `~${hours}h left`;
 }
-var isObject = (value) => !!value && typeof value === "object" && !Array.isArray(value);
-function parseGenerationRecord(input) {
-  let data = input;
-  if (typeof input === "string") {
-    try {
-      data = JSON.parse(input);
-    } catch {
-      throw new ProvenanceParseError("Generation record is not valid JSON.");
-    }
-  }
-  if (!isObject(data) || data.format !== GENERATION_RECORD_FORMAT) {
-    throw new ProvenanceParseError("Not a generation record.");
+function estimateJobProgress(input) {
+  const started = toMs(input.startedAt);
+  const now = toMs(input.now ?? Date.now());
+  const elapsedMs = Math.max(0, now - started);
+  if (input.done) return { percent: 100, label: "Done", elapsedMs, remainingMs: 0, overdue: false };
+  if (!Number.isFinite(started) || now <= started) {
+    return { percent: 0, label: "Starting\u2026", elapsedMs: 0, ...input.expectedMs ? { remainingMs: input.expectedMs } : {}, overdue: false };
   }
-  if (typeof data.version !== "number" || data.version > GENERATION_RECORD_VERSION) {
-    throw new ProvenanceParseError(`Unsupported generation record version ${JSON.stringify(data.version)}.`);
+  const expected = input.expectedMs;
+  if (!expected || !(expected > 0)) {
+    const percent2 = MAX_PENDING_PERCENT * (1 - Math.exp(-elapsedMs / UNKNOWN_DURATION_TAU_MS));
+    return { percent: Math.floor(percent2), label: "Working\u2026", elapsedMs, overdue: false };
   }
-  const checks = [
-    ["id", typeof data.id === "string" && data.id !== ""],
-    ["templates", Array.isArray(data.templates) && data.templates.every((t) => isObject(t) && typeof t.name === "string" && typeof t.hash === "string")],
-    ["assets", Array.isArray(data.assets) && data.assets.every((a) => isObject(a) && typeof a.id === "string" && typeof a.role === "string")],
-    ["settings", isObject(data.settings)],
-    ["promptHash", typeof data.promptHash === "string"],
-    ["createdAt", typeof data.createdAt === "string"]
-  ];
-  const bad = checks.find(([, ok]) => !ok);
-  if (bad) throw new ProvenanceParseError(`Invalid generation record field "${bad[0]}".`);
-  const provenance = parseProvenance(data.provenance);
+  const remainingMs = Math.max(0, expected - elapsedMs);
+  const percent = Math.min(MAX_PENDING_PERCENT, Math.floor(elapsedMs / expected * 100));
   return {
-    ...data,
-    kind: data.kind === "recreate" || data.kind === "variation" ? data.kind : "generate",
-    strategy: ["nearest", "upgrade", "downgrade", "error"].includes(data.strategy) ? data.strategy : "nearest",
-    provenance
+    percent,
+    label: remainingMs <= ALMOST_DONE_MS ? "Almost done\u2026" : formatRemaining(remainingMs),
+    elapsedMs,
+    remainingMs,
+    overdue: elapsedMs > expected
   };
 }
-function isGenerationRecord(value) {
-  return isObject(value) && value.format === GENERATION_RECORD_FORMAT;
-}
-var SKIPPED_SETTING_FIELDS = /* @__PURE__ */ new Set(["model", "prompt", "references", "params", "seed"]);
-function findModel(capabilities, modelId) {
-  if (!capabilities) return { given: false };
-  const list2 = Array.isArray(capabilities) ? capabilities : [capabilities];
-  return { given: true, caps: list2.find((m) => m.id === modelId) };
-}
-var sameValue = (a, b) => stableStringify(a) === stableStringify(b);
-var show = (value) => value === void 0 ? "unset" : typeof value === "string" ? `"${value}"` : JSON.stringify(value);
-var refKey = (ref) => `${ref.role}:${ref.id}`;
-function templateDrift(record, current, mode) {
-  if (!current) return [];
-  const byName = new Map(current.map((t) => [t.name, t]));
-  const drift = [];
-  for (const recorded of record.templates) {
-    const template = byName.get(recorded.name);
-    const fromVersion = recorded.version ?? recorded.versionId;
-    if (!template) {
-      drift.push({
-        type: "template-missing",
-        severity: "warning",
-        template: recorded.name,
-        from: fromVersion,
-        applied: false,
-        message: `Template "${recorded.name}" no longer exists; the recorded body is used.`
-      });
-      continue;
-    }
-    const body = getTemplateBody(template, {});
-    const hash = body === void 0 ? void 0 : hashText(body);
-    if (hash === recorded.hash) continue;
-    const latest = getLatestVersion(template);
-    const toVersion = template.versions?.length ? latest?.version ?? latest?.id : void 0;
-    const versions = fromVersion !== void 0 || toVersion !== void 0 ? ` (${fromVersion ?? "unversioned"} \u2192 ${toVersion ?? "unversioned"})` : "";
-    drift.push({
-      type: "template-changed",
-      severity: mode === "latest" ? "info" : "warning",
-      template: recorded.name,
-      from: { version: fromVersion, hash: recorded.hash },
-      to: { version: toVersion, hash },
-      applied: mode === "latest",
-      message: mode === "latest" ? `Template "${recorded.name}" changed since this generation${versions}; using the current version.` : `Template "${recorded.name}" changed since this generation${versions}; recreating with the recorded version.`
-    });
-  }
-  return drift;
+function expectedDurationFor(caps, request = {}) {
+  const timing = caps.timing;
+  if (!timing) return void 0;
+  const count = request.count ?? caps.count?.default ?? 1;
+  const duration = request.duration ?? caps.duration?.default ?? 0;
+  const resolution = request.resolution ?? caps.resolutions?.default;
+  const megapixels = resolution ? resolutionMegapixels(resolution) ?? 0 : 0;
+  return Math.round(
+    timing.baseMs + (timing.perItemMs ?? 0) * Math.max(0, count - 1) + (timing.perSecondMs ?? 0) * duration + (timing.perMegapixelMs ?? 0) * megapixels
+  );
 }
-function randomSeed(caps, previous, random) {
-  const cap = caps ? seedCapability(caps.seed) : {};
-  if (!cap) return void 0;
-  const min = Math.ceil(cap.min ?? 0);
-  const max = Math.floor(cap.max ?? 2 ** 31 - 1);
-  if (max < min) return min;
-  let seed = previous;
-  for (let attempt = 0; attempt < 8 && (seed === void 0 || seed === previous); attempt++) {
-    seed = min + Math.floor(random() * (max - min + 1));
-  }
-  if (seed === previous && max > min) seed = previous === max ? min : previous + 1;
-  return seed;
+
+// src/generation/controls.ts
+function enumControl(key, label, cap) {
+  if (!cap?.options.length) return null;
+  return {
+    key,
+    label,
+    kind: "select",
+    valueType: "string",
+    options: cap.options.map((value) => ({ value, label: cap.labels?.[value] ?? value })),
+    ...cap.default !== void 0 ? { defaultValue: cap.default } : {}
+  };
 }
-function rebuild(record, options, kind, overrides) {
-  const mode = options.mode ?? "exact";
-  const provenance = record.provenance;
-  const drift = templateDrift(record, options.templates, mode);
-  const rawPrompt = overrides?.rawPrompt ?? provenance.rawPrompt;
-  const values = overrides?.values !== void 0 ? { ...provenance.values ?? {}, ...overrides.values } : provenance.values ? clone2(provenance.values) : null;
-  const pinned = pinnedTemplatesToTemplates(provenance.templates);
-  let templates;
-  let bindings;
-  if (mode === "latest" && options.templates) {
-    const currentNames = new Set(options.templates.map((t) => t.name));
-    const fallback = pinned.filter((t) => !currentNames.has(t.name));
-    templates = [...options.templates.map((t) => ({ ...t })), ...fallback];
-    bindings = {};
-    for (const t of fallback) {
-      if (provenance.bindings[t.name] !== void 0) bindings[t.name] = provenance.bindings[t.name];
-    }
-  } else {
-    templates = pinned;
-    bindings = { ...provenance.bindings };
-  }
-  const resolved = resolvePrompt(rawPrompt, templates, { bindings, ...values ? { values } : {} });
-  const sourceMap = resolved.map.map((segment) => {
-    const { locked: _locked, ...rest } = segment;
-    return rest;
-  });
-  if (resolved.text !== provenance.resolvedPrompt && !overrides) {
-    drift.push({
-      type: "prompt-changed",
-      severity: "info",
-      from: provenance.resolvedPrompt,
-      to: resolved.text,
-      applied: true,
-      message: "The resolved prompt differs from the recorded one."
+function getGenerationControls(caps) {
+  const controls = [];
+  const modes = supportedModes(caps);
+  if (modes.length > 1) {
+    controls.push({
+      key: "mode",
+      label: "Mode",
+      kind: "select",
+      valueType: "string",
+      options: modes.map((m) => ({ value: m, label: m[0].toUpperCase() + m.slice(1) })),
+      defaultValue: "generate"
     });
   }
-  const base = clone2(mode === "exact" ? provenance.request : record.settings);
-  const recordedPlanned = provenance.request;
-  if (base.prompt === void 0 || base.prompt === provenance.resolvedPrompt) base.prompt = resolved.text;
-  else if (base.prompt === provenance.rawPrompt) base.prompt = rawPrompt;
-  if (mode === "latest" && record.mentions?.length) {
-    const plannedRole = new Map((recordedPlanned.references ?? []).map((ref) => [ref.id, ref.role]));
-    base.references = [
-      ...base.references ?? [],
-      ...record.mentions.map((m) => ({
-        id: m.id,
-        role: m.role || plannedRole.get(m.id) || "image_ref",
-        ...m.url !== void 0 ? { url: m.url } : {},
-        ...m.mediaType !== void 0 ? { mediaType: m.mediaType } : {},
-        ...m.contentHash !== void 0 ? { contentHash: m.contentHash } : {}
-      }))
-    ];
-  } else if (mode === "latest" && base.references === void 0 && recordedPlanned.references) {
-    base.references = clone2(recordedPlanned.references);
-  }
-  if (record.seed !== void 0) base.seed = record.seed;
-  base.model = provenance.modelId;
-  const { given, caps } = findModel(options.capabilities, provenance.modelId);
-  if (overrides) {
-    if (overrides.settings) {
-      const { params, ...rest } = overrides.settings;
-      Object.assign(base, clone2(rest));
-      if (params) base.params = { ...base.params ?? {}, ...clone2(params) };
-    }
-    if (overrides.seed === null) delete base.seed;
-    else base.seed = overrides.seed ?? randomSeed(caps, record.seed, overrides.random ?? Math.random);
-    if (base.seed === void 0) delete base.seed;
+  const negative = textFieldCapability(caps.negativePrompt);
+  if (negative) controls.push({ key: "negativePrompt", label: "Negative prompt", kind: "textarea", valueType: "string", maxLength: negative.maxLength });
+  const system = textFieldCapability(caps.systemPrompt);
+  if (system) controls.push({ key: "systemPrompt", label: "System prompt", kind: "textarea", valueType: "string", maxLength: system.maxLength });
+  controls.push(enumControl("aspectRatio", "Aspect ratio", caps.aspectRatios));
+  controls.push(enumControl("resolution", "Resolution", caps.resolutions));
+  controls.push(enumControl("quality", "Quality", caps.quality));
+  if (caps.count) {
+    const options = caps.count.options?.filter((o) => o >= 1 && o <= caps.count.max);
+    controls.push(
+      options?.length ? { key: "count", label: "Outputs", kind: "select", valueType: "number", options: options.map((o) => ({ value: o, label: String(o) })), defaultValue: caps.count.default } : { key: "count", label: "Outputs", kind: "range", valueType: "number", min: 1, max: caps.count.max, step: 1, defaultValue: caps.count.default ?? 1 }
+    );
   }
-  const resolveAsset = toAssetResolver(options.assets);
-  if (resolveAsset && base.references) {
-    const recordedById = new Map(record.assets.map((a) => [refKey(a), a]));
-    const kept = [];
-    for (const ref of base.references) {
-      const info = resolveAsset(ref.id);
-      if (!info) {
-        drift.push({
-          type: "asset-missing",
-          severity: "error",
-          assetId: ref.id,
-          role: ref.role,
-          message: `Asset "${ref.id}" (${ref.role}) is no longer available.`
-        });
-        continue;
-      }
-      const recordedHash = recordedById.get(refKey(ref))?.contentHash ?? ref.contentHash;
-      if (recordedHash !== void 0 && info.contentHash !== void 0 && recordedHash !== info.contentHash) {
-        drift.push({
-          type: "asset-changed",
-          severity: "warning",
-          assetId: ref.id,
-          role: ref.role,
-          from: recordedHash,
-          to: info.contentHash,
-          applied: true,
-          message: `Asset "${ref.id}" (${ref.role}) has changed since this generation.`
-        });
+  if (caps.duration) {
+    const d = caps.duration;
+    const options = d.options?.filter((o) => (d.min === void 0 || o >= d.min) && (d.max === void 0 || o <= d.max));
+    controls.push(
+      options?.length ? { key: "duration", label: "Duration (s)", kind: "select", valueType: "number", options: options.map((o) => ({ value: o, label: `${o}s` })), defaultValue: d.default } : {
+        key: "duration",
+        label: "Duration (s)",
+        kind: d.min !== void 0 && d.max !== void 0 ? "range" : "number",
+        valueType: "number",
+        min: d.min,
+        max: d.max,
+        step: d.step,
+        defaultValue: d.default
       }
-      const next = { ...ref };
-      if (info.contentHash !== void 0) next.contentHash = info.contentHash;
-      if (next.mediaType === void 0 && info.mediaType !== void 0) next.mediaType = info.mediaType;
-      kept.push(next);
-    }
-    if (kept.length) base.references = kept;
-    else delete base.references;
+    );
   }
-  let plan;
-  let request = base;
-  if (given && !caps) {
-    drift.push({
-      type: "model-missing",
-      severity: "error",
-      modelId: provenance.modelId,
-      message: `Model "${provenance.modelId}" is no longer available.`
-    });
-  } else if (caps) {
-    const capabilityHash = hashCapabilities(caps);
-    if (record.capabilityHash !== void 0 && record.capabilityHash !== capabilityHash) {
-      drift.push({
-        type: "model-changed",
-        severity: "warning",
-        modelId: caps.id,
-        from: record.capabilityHash,
-        to: capabilityHash,
-        message: `The capabilities of "${caps.name ?? caps.id}" changed since this generation.`
-      });
-    }
-    plan = planGenerationRequest(base, caps, {
-      strategy: options.strategy ?? record.strategy,
-      resolvedPrompt: resolved.text
-    });
-    request = plan.request;
-    const severity = mode === "exact" && !overrides ? "warning" : "info";
-    const type = mode === "exact" && !overrides ? "setting-unsupported" : "setting-changed";
-    const describeChange = (field, from, to) => {
-      const adjustment = plan.adjustments.find((a) => a.field === field || a.field.startsWith(`${field}.`));
-      drift.push({
-        type,
-        severity,
-        field,
-        from,
-        to,
-        applied: true,
-        message: type === "setting-unsupported" ? `${field} ${show(from)} is no longer supported; using ${show(to)}.${adjustment ? ` ${adjustment.reason}` : ""}` : `${field} was ${show(from)}, now ${show(to)}.${adjustment ? ` ${adjustment.reason}` : ""}`
+  const seed = seedCapability(caps.seed);
+  if (seed) controls.push({ key: "seed", label: "Seed", kind: "number", valueType: "number", min: seed.min, max: seed.max, step: 1 });
+  for (const [name, spec] of Object.entries(caps.params ?? {})) {
+    const base = { key: `params.${name}`, label: spec.label ?? name, ...spec.description ? { description: spec.description } : {} };
+    if (spec.type === "boolean") {
+      controls.push({ ...base, kind: "checkbox", valueType: "boolean", defaultValue: spec.default });
+    } else if (spec.type === "enum") {
+      const numeric = spec.options.every((o) => typeof o === "number");
+      controls.push({
+        ...base,
+        kind: "select",
+        valueType: numeric ? "number" : "string",
+        options: spec.options.map((value) => ({ value, label: String(value) })),
+        defaultValue: spec.default
       });
-    };
-    if (!overrides) {
-      for (const field of GENERATION_REQUEST_FIELDS) {
-        if (SKIPPED_SETTING_FIELDS.has(field)) continue;
-        const from = recordedPlanned[field];
-        const to = request[field];
-        if (!sameValue(from, to)) describeChange(field, from, to);
-      }
-      const paramNames = /* @__PURE__ */ new Set([...Object.keys(recordedPlanned.params ?? {}), ...Object.keys(request.params ?? {})]);
-      for (const name of [...paramNames].sort()) {
-        const from = recordedPlanned.params?.[name];
-        const to = request.params?.[name];
-        if (!sameValue(from, to)) describeChange(`params.${name}`, from, to);
-      }
-      if (!sameValue(record.seed ?? recordedPlanned.seed, request.seed)) describeChange("seed", record.seed ?? recordedPlanned.seed, request.seed);
-      const missing = new Set(drift.filter((d) => d.type === "asset-missing").map((d) => `${d.role}:${d.assetId}`));
-      const fromRefs = (recordedPlanned.references ?? []).map(refKey).filter((key) => !missing.has(key));
-      const toRefs = (request.references ?? []).map(refKey);
-      if (!sameValue(fromRefs, toRefs)) describeChange("references", fromRefs, toRefs);
-    }
-    for (const error of plan.errors) {
-      drift.push({
-        type: "setting-unsupported",
-        severity: "error",
-        field: error.field,
-        from: error.value,
-        message: error.message
+    } else {
+      controls.push({
+        ...base,
+        kind: spec.min !== void 0 && spec.max !== void 0 ? "range" : "number",
+        valueType: "number",
+        min: spec.min,
+        max: spec.max,
+        step: spec.step ?? (spec.type === "integer" ? 1 : void 0),
+        defaultValue: spec.default
       });
     }
   }
-  const ok = !drift.some((d) => d.severity === "error") && (plan ? plan.ok : true);
-  const recordOptions = {
-    rawPrompt,
-    templates,
-    bindings,
-    ...values ? { values } : {},
-    model: caps ?? provenance.modelId,
-    request,
-    ...plan ? { plan } : {},
-    strategy: options.strategy ?? record.strategy,
-    parentId: record.id,
-    kind
-  };
-  return {
-    mode,
-    ok,
-    request,
-    ...plan ? { plan } : {},
-    rawPrompt,
-    resolvedPrompt: resolved.text,
-    sourceMap,
-    values,
-    templates,
-    bindings,
-    drift,
-    parentId: record.id,
-    kind,
-    recordOptions
-  };
+  return controls.filter((c) => c !== null);
 }
-function recreateRequest(input, options) {
-  if (isGenerationRecord(input)) return rebuild(input, options ?? {}, "recreate");
-  const provenance = input;
-  const request = clone2(provenance.request);
-  request.model = provenance.modelId;
-  if (request.prompt === void 0) request.prompt = provenance.resolvedPrompt;
-  return request;
+function getRequestValue(request, key) {
+  if (key.startsWith("params.")) return request.params?.[key.slice(7)];
+  return request[key];
 }
-function variationRequest(record, overrides = {}, options = {}) {
-  return rebuild(record, options, "variation", overrides);
+function setRequestValue(request, key, value) {
+  const remove = value === void 0 || value === "" || typeof value === "number" && Number.isNaN(value);
+  if (key.startsWith("params.")) {
+    const name = key.slice(7);
+    const params = { ...request.params ?? {} };
+    if (remove) delete params[name];
+    else params[name] = value;
+    const next2 = { ...request, params };
+    if (Object.keys(params).length === 0) delete next2.params;
+    return next2;
+  }
+  const next = { ...request };
+  if (remove) delete next[key];
+  else next[key] = value;
+  return next;
 }
-var DRIFT_TYPE_LABELS = {
-  "template-changed": "Template changed",
-  "template-missing": "Template deleted",
-  "prompt-changed": "Prompt changed",
-  "model-missing": "Model unavailable",
-  "model-changed": "Model changed",
-  "setting-unsupported": "Setting unsupported",
-  "setting-changed": "Setting changed",
-  "asset-missing": "Asset missing",
-  "asset-changed": "Asset changed"
-};
-function blockingDrift(drift) {
-  return drift.filter((d) => d.severity === "error");
+function parseControlValue(control, raw) {
+  if (control.valueType === "boolean") return Boolean(raw);
+  if (raw === "" || raw === void 0) return void 0;
+  if (control.valueType === "number") {
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : void 0;
+  }
+  return String(raw);
+}
+function getReferenceSlots(caps, request = {}) {
+  const roles = supportedReferenceRoles(caps);
+  if (caps.inpainting && !roles.includes("mask")) roles.push("mask");
+  const refs = request.references ?? [];
+  const total = refs.length;
+  const maxTotal = caps.references?.maxTotal ?? Infinity;
+  return roles.map((role) => {
+    const cap = caps.references?.roles[role] ?? { max: 1 };
+    const references = refs.filter((ref) => ref.role === role);
+    return {
+      role,
+      label: referenceRoleLabel(role, caps),
+      ...cap.description ? { description: cap.description } : {},
+      ..."accepts" in cap && cap.accepts?.length ? { accepts: [...cap.accepts] } : {},
+      min: cap.min ?? 0,
+      max: cap.max,
+      references,
+      canAdd: references.length < cap.max && total < maxTotal
+    };
+  });
+}
+function addReference(request, reference) {
+  return { ...request, references: [...request.references ?? [], { ...reference }] };
+}
+function removeReference(request, role, id) {
+  const references = (request.references ?? []).filter((ref) => !(ref.role === role && ref.id === id));
+  const next = { ...request, references };
+  if (references.length === 0) delete next.references;
+  return next;
 }
 
 // src/generation/store.ts
@@ -2260,6 +2400,7 @@ export {
   capabilitiesToJsonSchema,
   completeGenerationRecord,
   createBatchResolver,
+  createGenerationHistoryToolProvider,
   createGenerationRecord,
   createGenerationRecordId,
   createGenerationRecordStore,