@goodandready/dsh-image-gen 0.11.39 → 0.11.41

package/lib/client.js

@@ -360,6 +360,7 @@ window.__ModuleLoader__.load({
       { field: 'toolsetProcessing', spec: booleanField('toolsetProcessing'), kind: 'select', options: ['true', 'false'], labelKey: 'f.toolsetProcessing', hintKey: 'f.toolsetProcessingHint', tab: 'general' },
       { field: 'toolsetFrontend', spec: booleanField('toolsetFrontend'), kind: 'select', options: ['true', 'false'], labelKey: 'f.toolsetFrontend', hintKey: 'f.toolsetFrontendHint', tab: 'general' },
       { field: 'toolsetCreative', spec: booleanField('toolsetCreative'), kind: 'select', options: ['true', 'false'], labelKey: 'f.toolsetCreative', hintKey: 'f.toolsetCreativeHint', tab: 'general' },
+      { field: 'activeProjectProfile', spec: selectField('activeProjectProfile', ['', 'cyberpunk_neon', 'minimal_nordic', 'corporate_editorial']), kind: 'select', options: ['', 'cyberpunk_neon', 'minimal_nordic', 'corporate_editorial'], labelKey: 'f.activeProjectProfile', hintKey: 'f.activeProjectProfileHint', tab: 'general' },
 
       // Provider: FAL
       { field: 'model', spec: textField('model'), kind: 'text', labelKey: 'f.model', hintKey: 'f.modelHint', placeholderKey: 'p.model', when: ['fal'], tab: 'provider' },
@@ -2878,6 +2879,8 @@ window.__ModuleLoader__.load({
       'vault.title': 'Asset Browser & Vault',
       'f.comfyTemplate': 'ComfyUI Workflow Template',
       'f.comfyTemplateHint': 'Pre-vetted workflow template (e.g. SDXL txt2img, img2img, InstantID face transfer, RealESRGAN upscaler).',
+      'f.activeProjectProfile': 'Active Project Profile',
+      'f.activeProjectProfileHint': 'Select a saved visual profile (palette, style, format) to consistently apply across generations (#435).',
     }
     const zh = {
       'card.actionRemoveBg': '移除背景',
@@ -3187,6 +3190,8 @@ window.__ModuleLoader__.load({
       'vault.title': '图像素材库与浏览器',
       'f.comfyTemplate': 'ComfyUI 工作流模板',
       'f.comfyTemplateHint': '经过验证的预设工作流模板（例如 SDXL 文生图、图生图、InstantID 人脸迁移、RealESRGAN 放大器）。',
+      'f.activeProjectProfile': '活动项目视觉配置',
+      'f.activeProjectProfileHint': '选择已保存的项目视觉配置（调色板、风格、格式），跨多次生成统一应用 (#435)。',
     }
     // Dual compatibility with DSH 0.1.5-rc.3 (settingsScope) and 0.1.6+ (configForms) (#291, #295)
     const inject = ['slots', 'locale', 'sessions']

package/lib/config-schema.js

@@ -220,6 +220,11 @@ export const Config = z.object({
     .description('Vetted ComfyUI workflow template identifier (e.g. "txt2img_sdxl", "img2img_sdxl", "face_instantid", "upscale_esrgan").')
     .default('')
     .volatile(),
+  activeProjectProfile: z
+    .string()
+    .description('Active project visual profile for continuous multi-image styling (#435). One of: "", "cyberpunk_neon", "minimal_nordic", "corporate_editorial".')
+    .default('')
+    .volatile(),
   comfyWorkflowJson: z
     .string()
     .description('Custom ComfyUI API workflow JSON template with {{prompt}}, {{seed}}, etc. placeholders.')

package/lib/index.js

@@ -50,6 +50,10 @@ import { clearAllAnchors } from './anchor-helpers.js'
 import { clearSpendReservations } from './cost-meter.js'
 import { getAllRecipes, getRecipe } from './recipes.js'
 import { getComfyTemplates, getComfyTemplate, createComfyDependencyValidator } from './comfy-catalog.js'
+import { getCapabilityRegistry, filterModelsByCapabilities, recommendModelForTask } from './capabilities.js'
+import { getAllProjectProfiles, saveCustomProfile, deleteCustomProfile } from './project-profiles.js'
+import { getStagingSession, reviewStagedEdit, createStagingSession } from './inpaint-staging.js'
+import { enqueueBatch, getBatchQueue, getBatchProgress, cancelBatch, retryFailedBatchItems, reconcileQueueOnStartup } from './batch-queue.js'
 import { resetLoopGuard, getLoopGuardState } from './loop-guard.js'
 import { Config, plainConfig, volatileConfig, publicConfig, ensureConfig } from './config-schema.js'
 import { resolveSource } from './resolve-source.js'
@@ -465,7 +469,120 @@ export function apply(ctx, rawConfig) {
     },
   }), 'dsh-image-gen: comfy templates route')
 
+  // Capabilities route (#434)
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-image-gen/capabilities',
+    handler: async (req, res) => {
+      if (req.method !== 'GET') {
+        res.writeHead(405, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ error: 'GET only' }))
+        return
+      }
+      res.writeHead(200, { 'Content-Type': 'application/json' })
+      res.end(JSON.stringify({ ok: true, registry: getCapabilityRegistry() }))
+    },
+  }), 'dsh-image-gen: capabilities route')
+
+  // Project profiles route (#435)
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-image-gen/profiles',
+    handler: async (req, res) => {
+      if (req.method === 'GET') {
+        res.writeHead(200, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ ok: true, profiles: getAllProjectProfiles() }))
+        return
+      }
+      if (req.method === 'POST') {
+        try {
+          const body = await readBoundedRequestBody(req, 1024 * 1024)
+          const data = JSON.parse(body.toString('utf8'))
+          const saved = saveCustomProfile(data)
+          res.writeHead(200, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({ ok: true, profile: saved }))
+        } catch (err) {
+          res.writeHead(400, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({ ok: false, error: err.message }))
+        }
+        return
+      }
+      res.writeHead(405, { 'Content-Type': 'application/json' })
+      res.end(JSON.stringify({ error: 'GET or POST only' }))
+    },
+  }), 'dsh-image-gen: project profiles route')
+
   // Live events route (#379)
+  // Reconcile batch queues on startup (#437)
+  try {
+    reconcileQueueOnStartup()
+  } catch (err) {
+    // Non-fatal if queue storage is empty or initial
+  }
+
+  // Inpaint staging route (#436)
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-image-gen/staging',
+    handler: async (req, res) => {
+      const url = new URL(req.url, 'http://localhost')
+      if (req.method === 'GET') {
+        const stageId = url.searchParams.get('stageId')
+        const session = stageId ? getStagingSession(stageId) : null
+        res.writeHead(200, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ ok: Boolean(session), session }))
+        return
+      }
+      if (req.method === 'POST') {
+        try {
+          const body = await readBoundedRequestBody(req, 1024 * 1024)
+          const data = JSON.parse(body.toString('utf8'))
+          const review = reviewStagedEdit(data.stageId, data.action, data)
+          res.writeHead(review.ok ? 200 : 400, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify(review))
+        } catch (err) {
+          res.writeHead(400, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({ ok: false, error: err.message }))
+        }
+        return
+      }
+      res.writeHead(405, { 'Content-Type': 'application/json' })
+      res.end(JSON.stringify({ error: 'GET or POST only' }))
+    },
+  }), 'dsh-image-gen: staging route')
+
+  // Batch queue route (#437)
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-image-gen/queue',
+    handler: async (req, res) => {
+      const url = new URL(req.url, 'http://localhost')
+      if (req.method === 'GET') {
+        const batchId = url.searchParams.get('batchId')
+        const batch = batchId ? getBatchQueue(batchId) : null
+        const progress = batch ? getBatchProgress(batch) : null
+        res.writeHead(200, { 'Content-Type': 'application/json' })
+        res.end(JSON.stringify({ ok: Boolean(batch), batch, progress }))
+        return
+      }
+      if (req.method === 'POST') {
+        try {
+          const body = await readBoundedRequestBody(req, 1024 * 1024)
+          const data = JSON.parse(body.toString('utf8'))
+          const batch = enqueueBatch(data)
+          res.writeHead(200, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({ ok: true, batch }))
+        } catch (err) {
+          res.writeHead(400, { 'Content-Type': 'application/json' })
+          res.end(JSON.stringify({ ok: false, error: err.message }))
+        }
+        return
+      }
+      res.writeHead(405, { 'Content-Type': 'application/json' })
+      res.end(JSON.stringify({ error: 'GET or POST only' }))
+    },
+  }), 'dsh-image-gen: batch queue route')
+
   registerLiveProgressRoutes(ctx)
 
   // Reset loop guard when user sends a new message (#370)

package/lib/inpaint-staging.js

@@ -0,0 +1,236 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+import sharp from 'sharp'
+
+/**
+ * Inpaint Staging & Review Workflow (#436)
+ * Enables review/accept/reject cycle for localized image edits,
+ * preserving original image data and supporting pixel-level compositing.
+ */
+
+export function getStagingStoragePath(customPath) {
+  if (customPath) return customPath
+  if (process.env.DSH_STAGING_STORAGE_PATH) return process.env.DSH_STAGING_STORAGE_PATH
+  const home = os.homedir() || '/tmp'
+  return path.join(home, '.dsh', 'dsh-image-gen', 'staging-sessions.json')
+}
+
+export function loadStagingSessions(storagePath) {
+  const filePath = getStagingStoragePath(storagePath)
+  try {
+    if (!fs.existsSync(filePath)) return []
+    const raw = fs.readFileSync(filePath, 'utf8')
+    const parsed = JSON.parse(raw)
+    return Array.isArray(parsed) ? parsed : []
+  } catch (err) {
+    return []
+  }
+}
+
+export function saveStagingSession(session, storagePath) {
+  const filePath = getStagingStoragePath(storagePath)
+  const dir = path.dirname(filePath)
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true })
+  }
+
+  const existing = loadStagingSessions(storagePath)
+  const index = existing.findIndex((s) => s.stageId === session.stageId)
+  if (index >= 0) {
+    existing[index] = session
+  } else {
+    existing.push(session)
+  }
+  fs.writeFileSync(filePath, JSON.stringify(existing, null, 2), 'utf8')
+  return session
+}
+
+export function getStagingSession(stageId, storagePath) {
+  const sessions = loadStagingSessions(storagePath)
+  return sessions.find((s) => s.stageId === stageId) || null
+}
+
+/**
+ * Creates a new inpaint staging session.
+ */
+export function createStagingSession(params, storagePath) {
+  const {
+    originalImage,
+    mask,
+    bbox,
+    prompt,
+    previewImage,
+    provider = 'fal',
+    model = 'default',
+    estimatedCost = 0.02,
+  } = params
+
+  if (!originalImage) {
+    throw new Error('originalImage is required to initialize staging session')
+  }
+
+  const stageId = `stage_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`
+  const session = {
+    stageId,
+    createdAt: new Date().toISOString(),
+    status: 'staged',
+    originalImage,
+    mask: mask || null,
+    bbox: bbox || null,
+    prompt: prompt || '',
+    previewImage: previewImage || null,
+    provider,
+    model,
+    estimatedCost,
+    history: [
+      {
+        action: 'created',
+        timestamp: new Date().toISOString(),
+        prompt: prompt || '',
+      },
+    ],
+  }
+
+  return saveStagingSession(session, storagePath)
+}
+
+/**
+ * Reviews a staged edit: accept, reject, retry, or cancel.
+ */
+export function reviewStagedEdit(stageId, action, options = {}, storagePath) {
+  const session = getStagingSession(stageId, storagePath)
+  if (!session) {
+    return {
+      ok: false,
+      error: `Staging session "${stageId}" not found.`,
+    }
+  }
+
+  if (session.status !== 'staged') {
+    return {
+      ok: false,
+      error: `Staging session "${stageId}" is already finalized with status "${session.status}".`,
+    }
+  }
+
+  const timestamp = new Date().toISOString()
+
+  if (action === 'accept') {
+    session.status = 'accepted'
+    session.resolvedAt = timestamp
+    session.history.push({ action: 'accepted', timestamp })
+    saveStagingSession(session, storagePath)
+    return {
+      ok: true,
+      status: 'accepted',
+      stageId,
+      finalImage: session.previewImage,
+      originalImage: session.originalImage,
+      parentImageId: session.originalImage,
+      message: 'Staged edit accepted. Result is committed as active version.',
+    }
+  }
+
+  if (action === 'reject') {
+    session.status = 'rejected'
+    session.resolvedAt = timestamp
+    session.history.push({ action: 'rejected', timestamp, reason: options.reason || 'User rejected preview' })
+    saveStagingSession(session, storagePath)
+    return {
+      ok: true,
+      status: 'rejected',
+      stageId,
+      originalImage: session.originalImage,
+      discardedPreview: session.previewImage,
+      message: 'Staged edit rejected. Original image remains untouched.',
+    }
+  }
+
+  if (action === 'cancel') {
+    session.status = 'cancelled'
+    session.resolvedAt = timestamp
+    session.history.push({ action: 'cancelled', timestamp })
+    saveStagingSession(session, storagePath)
+    return {
+      ok: true,
+      status: 'cancelled',
+      stageId,
+      originalImage: session.originalImage,
+      message: 'Staging session cancelled.',
+    }
+  }
+
+  if (action === 'retry') {
+    const newPrompt = options.prompt || session.prompt
+    session.history.push({
+      action: 'retry_requested',
+      timestamp,
+      prompt: newPrompt,
+    })
+    session.prompt = newPrompt
+    if (options.previewImage) {
+      session.previewImage = options.previewImage
+    }
+    saveStagingSession(session, storagePath)
+    return {
+      ok: true,
+      status: 'staged',
+      stageId,
+      prompt: newPrompt,
+      retryCount: session.history.filter((h) => h.action === 'retry_requested').length,
+      estimatedCost: session.estimatedCost,
+      message: 'Staged edit updated for retry.',
+    }
+  }
+
+  return {
+    ok: false,
+    error: `Unknown review action "${action}". Allowed: accept, reject, retry, cancel.`,
+  }
+}
+
+/**
+ * Pixel-level local compositing:
+ * Overlays edited region back onto the original image using Sharp,
+ * guaranteeing that pixels outside the modified area remain 100% identical to the source.
+ */
+export async function compositeInpaintPatch(originalBuffer, inpaintBuffer, maskBbox, dimensions = {}) {
+  const origMeta = await sharp(originalBuffer).metadata()
+  const width = dimensions.width || origMeta.width || 1024
+  const height = dimensions.height || origMeta.height || 1024
+
+  // If bounding box provided, crop or position patch over original
+  if (Array.isArray(maskBbox) && maskBbox.length === 4) {
+    let [x1, y1, x2, y2] = maskBbox
+    if (x1 > 1000 || y1 > 1000 || x2 > 1000 || y2 > 1000) {
+      // already in pixels
+    } else {
+      // normalized 0-1000
+      x1 = Math.round((x1 / 1000) * width)
+      y1 = Math.round((y1 / 1000) * height)
+      x2 = Math.round((x2 / 1000) * width)
+      y2 = Math.round((y2 / 1000) * height)
+    }
+
+    const patchW = Math.max(1, x2 - x1)
+    const patchH = Math.max(1, y2 - y1)
+
+    const resizedPatch = await sharp(inpaintBuffer)
+      .resize(patchW, patchH, { fit: 'fill' })
+      .toBuffer()
+
+    return sharp(originalBuffer)
+      .composite([{ input: resizedPatch, left: x1, top: y1 }])
+      .toBuffer()
+  }
+
+  // Full composite when dimensions match
+  const resizedInpaint = await sharp(inpaintBuffer)
+    .resize(width, height, { fit: 'fill' })
+    .toBuffer()
+
+  return sharp(originalBuffer)
+    .composite([{ input: resizedInpaint, blend: 'over' }])
+    .toBuffer()
+}

package/lib/project-profiles.js

@@ -0,0 +1,234 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import os from 'node:os'
+
+/**
+ * Visual Project & Series Profiles (#435)
+ * Manages persistent project visual profiles with explicit scope,
+ * parameter cascade (defaults -> profile -> request), and immutable history tagging.
+ */
+
+export const BUILTIN_PROJECT_PROFILES = [
+  {
+    id: 'cyberpunk_neon',
+    name: 'Cyberpunk Neon',
+    version: '1.0.0',
+    description: 'High contrast neon lighting and dark futuristic styling.',
+    palette: ['#00f0ff', '#ff003c', '#ffe600', '#0a0a12'],
+    stylePrompt: 'cyberpunk aesthetic, volumetric atmospheric lighting, raytracing, sharp neon accents, highly detailed 8k',
+    negativePrompt: 'washed out, vintage, pastel, desaturated, noisy',
+    format: { size: '1024x1024', aspect: '1:1', format: 'webp' },
+    rules: {
+      background: 'dark cityscapes or moody interior',
+      typography: 'clean monospace or futuristic geometric',
+    },
+    allowedModels: ['fal-ai/flux/dev', 'sdxl_base'],
+    builtin: true,
+  },
+  {
+    id: 'minimal_nordic',
+    name: 'Scandinavian Minimalist',
+    version: '1.0.0',
+    description: 'Warm daylight, matte textures, and understated earthy tones.',
+    palette: ['#f4f1de', '#e07a5f', '#3d405b', '#81b29a'],
+    stylePrompt: 'scandinavian minimalism, clean composition, soft natural daylight, matte surfaces, earthy organic elegance',
+    negativePrompt: 'cluttered, neon, heavy shadows, oversaturated, glossy plastic',
+    format: { size: '1024x1024', aspect: '1:1', format: 'png' },
+    rules: {
+      background: 'plain textured warm neutral',
+      typography: 'light grotesque sans',
+    },
+    allowedModels: ['fal-ai/flux/dev', 'imagen-3.0-generate-002'],
+    builtin: true,
+  },
+  {
+    id: 'corporate_editorial',
+    name: 'Corporate Editorial',
+    version: '1.0.0',
+    description: 'High-end business magazine photography with crisp studio lighting.',
+    palette: ['#0f172a', '#3b82f6', '#64748b', '#f8fafc'],
+    stylePrompt: 'high-end corporate magazine editorial, crisp balanced studio lighting, premium commercial photography',
+    negativePrompt: 'anime, cartoon, oversaturated, exaggerated distortions, amateur',
+    format: { size: '1024x1024', aspect: '16:9', format: 'webp' },
+    rules: {
+      background: 'architectural soft blur or pristine studio',
+      typography: 'editorial serif / humanistic sans',
+    },
+    allowedModels: ['fal-ai/flux/dev', 'black-forest-labs/flux-1.1-pro'],
+    builtin: true,
+  },
+]
+
+export function getProfilesStoragePath(customPath) {
+  if (customPath) return customPath
+  if (process.env.DSH_PROJECT_PROFILES_PATH) return process.env.DSH_PROJECT_PROFILES_PATH
+  const home = os.homedir() || '/tmp'
+  return path.join(home, '.dsh', 'dsh-image-gen', 'project-profiles.json')
+}
+
+export function loadCustomProfiles(storagePath) {
+  const filePath = getProfilesStoragePath(storagePath)
+  try {
+    if (!fs.existsSync(filePath)) return []
+    const content = fs.readFileSync(filePath, 'utf8')
+    const parsed = JSON.parse(content)
+    return Array.isArray(parsed) ? parsed : []
+  } catch (err) {
+    return []
+  }
+}
+
+export function saveCustomProfile(profile, storagePath) {
+  if (!profile || typeof profile !== 'object') {
+    throw new Error('Invalid project profile: object required')
+  }
+  if (!profile.id || typeof profile.id !== 'string') {
+    throw new Error('Project profile requires a string "id"')
+  }
+  if (!profile.name || typeof profile.name !== 'string') {
+    throw new Error('Project profile requires a string "name"')
+  }
+
+  const filePath = getProfilesStoragePath(storagePath)
+  const dir = path.dirname(filePath)
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true })
+  }
+
+  const existing = loadCustomProfiles(storagePath)
+  const index = existing.findIndex((p) => p.id === profile.id)
+  const prepared = {
+    ...profile,
+    version: profile.version || '1.0.0',
+    builtin: false,
+    updatedAt: new Date().toISOString(),
+  }
+
+  if (index >= 0) {
+    existing[index] = prepared
+  } else {
+    existing.push(prepared)
+  }
+
+  fs.writeFileSync(filePath, JSON.stringify(existing, null, 2), 'utf8')
+  return prepared
+}
+
+export function deleteCustomProfile(id, storagePath) {
+  const filePath = getProfilesStoragePath(storagePath)
+  const existing = loadCustomProfiles(storagePath)
+  const filtered = existing.filter((p) => p.id !== id)
+  if (filtered.length === existing.length) {
+    return false
+  }
+  fs.writeFileSync(filePath, JSON.stringify(filtered, null, 2), 'utf8')
+  return true
+}
+
+export function getAllProjectProfiles(storagePath) {
+  const custom = loadCustomProfiles(storagePath)
+  const customIds = new Set(custom.map((c) => c.id))
+  const builtins = BUILTIN_PROJECT_PROFILES.filter((b) => !customIds.has(b.id))
+  return [...builtins, ...custom]
+}
+
+export function getProjectProfileById(id, storagePath) {
+  if (!id) return null
+  const all = getAllProjectProfiles(storagePath)
+  return all.find((p) => p.id === id) || null
+}
+
+/**
+ * Parameter resolution cascade (#435):
+ * Priority: Request parameters > Project Profile > System Defaults.
+ * Returns effective params, provenance mapping, and immutable profile tag for history.
+ */
+export function resolveEffectiveParams(requestParams = {}, profileId = null, storagePath = null) {
+  const profile = profileId ? getProjectProfileById(profileId, storagePath) : null
+  const provenance = {}
+  const effective = {}
+
+  // 1. Defaults
+  const defaults = {
+    size: '1024x1024',
+    format: 'webp',
+    negativePrompt: '',
+    steps: 25,
+    cfg: 7,
+  }
+
+  for (const [key, val] of Object.entries(defaults)) {
+    effective[key] = val
+    provenance[key] = 'default'
+  }
+
+  // 2. Profile layer
+  if (profile) {
+    if (profile.format?.size) {
+      effective.size = profile.format.size
+      provenance.size = 'profile'
+    }
+    if (profile.format?.format) {
+      effective.format = profile.format.format
+      provenance.format = 'profile'
+    }
+    if (profile.negativePrompt) {
+      effective.negativePrompt = profile.negativePrompt
+      provenance.negativePrompt = 'profile'
+    }
+    if (profile.stylePrompt) {
+      effective.stylePrompt = profile.stylePrompt
+      provenance.stylePrompt = 'profile'
+    }
+    if (Array.isArray(profile.palette) && profile.palette.length > 0) {
+      effective.palette = [...profile.palette]
+      provenance.palette = 'profile'
+    }
+    if (profile.rules) {
+      effective.rules = { ...profile.rules }
+      provenance.rules = 'profile'
+    }
+  }
+
+  // 3. Request layer (highest precedence)
+  for (const [key, val] of Object.entries(requestParams)) {
+    if (val !== undefined && val !== null) {
+      if (key === 'prompt') {
+        // Synthesize prompt with profile style if available
+        if (effective.stylePrompt) {
+          effective.prompt = `${val}, ${effective.stylePrompt}`
+          provenance.prompt = 'request+profile'
+        } else {
+          effective.prompt = val
+          provenance.prompt = 'request'
+        }
+      } else if (key === 'negativePrompt') {
+        if (effective.negativePrompt && val) {
+          effective.negativePrompt = `${effective.negativePrompt}, ${val}`
+          provenance.negativePrompt = 'request+profile'
+        } else {
+          effective.negativePrompt = val || effective.negativePrompt
+          provenance.negativePrompt = 'request'
+        }
+      } else {
+        effective[key] = val
+        provenance[key] = 'request'
+      }
+    }
+  }
+
+  // Immutable applied profile metadata snapshot for history
+  const appliedProfile = profile
+    ? {
+        id: profile.id,
+        name: profile.name,
+        version: profile.version || '1.0.0',
+      }
+    : null
+
+  return {
+    effectiveParams: effective,
+    provenance,
+    appliedProfile,
+  }
+}

package/lib/register-tools.js

@@ -20,6 +20,10 @@ import { registerCharacterSheetTools } from './tools/character-sheet.js'
 import { registerVisionOcrTools } from './tools/vision-ocr.js'
 import { registerDiagramTools } from './tools/diagram.js'
 import { registerRecipeTools } from './tools/recipes.js'
+import { registerCapabilityTools } from './tools/capabilities.js'
+import { registerProjectProfileTools } from './tools/project-profiles.js'
+import { registerInpaintStagingTools } from './tools/inpaint-staging.js'
+import { registerBatchQueueTools } from './tools/batch-queue.js'
 import {
   createLiveProgressSession,
   publishLiveProgress,
@@ -149,6 +153,18 @@ export function registerAllTools(ctx, deps) {
     if (Boolean(sets.recipes)) {
       registerRecipeTools(targetCtx, { ...deps, toolDispatcher })
     }
+    if (Boolean(sets.capabilities)) {
+      registerCapabilityTools(targetCtx, deps)
+    }
+    if (Boolean(sets.profiles)) {
+      registerProjectProfileTools(targetCtx, deps)
+    }
+    if (Boolean(sets.staging)) {
+      registerInpaintStagingTools(targetCtx, deps)
+    }
+    if (Boolean(sets.queue)) {
+      registerBatchQueueTools(targetCtx, deps)
+    }
   }
 
   function dispose() {