@goodandready/dsh-image-gen 0.11.12 → 0.11.14

package/lib/client.js

@@ -287,6 +287,11 @@ window.__ModuleLoader__.load({
       { field: 'deliverAs', spec: selectField('deliverAs', DELIVERY_MODES), kind: 'select', options: DELIVERY_MODES, labelKey: 'f.deliverAs', hintKey: 'f.deliverAsHint', tab: 'general' },
       { field: 'outputDir', spec: textField('outputDir'), kind: 'text', labelKey: 'f.outputDir', hintKey: 'f.outputDirHint', placeholderKey: 'p.outputDir', tab: 'general' },
       { field: 'historyLimit', spec: numberField('historyLimit'), kind: 'number', labelKey: 'f.historyLimit', hintKey: 'f.historyLimitHint', placeholderKey: 'p.historyLimit', tab: 'general' },
+      { field: 'toolsetProfile', spec: selectField('toolsetProfile', ['minimal', 'all', 'custom']), kind: 'select', options: ['minimal', 'all', 'custom'], labelKey: 'f.toolsetProfile', hintKey: 'f.toolsetProfileHint', tab: 'general' },
+      { field: 'toolsetDesign', spec: booleanField('toolsetDesign'), kind: 'select', options: ['true', 'false'], labelKey: 'f.toolsetDesign', hintKey: 'f.toolsetDesignHint', tab: 'general' },
+      { 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' },
 
       // Provider: FAL
       { field: 'model', spec: textField('model'), kind: 'text', labelKey: 'f.model', hintKey: 'f.modelHint', placeholderKey: 'p.model', when: ['fal'], tab: 'provider' },
@@ -2458,6 +2463,16 @@ window.__ModuleLoader__.load({
       'p.outputDir': 'generated/images',
       'f.historyLimit': 'History Limit',
       'f.historyLimitHint': 'Maximum number of recent generation records kept in memory.',
+      'f.toolsetProfile': 'Toolset Profile',
+      'f.toolsetProfileHint': 'Select which tools to register into context: minimal (<= 3 core tools, saving ~8k prompt tokens), all (30 tools), or custom.',
+      'f.toolsetDesign': 'Design Toolset',
+      'f.toolsetDesignHint': 'Enable design tools: style_matrix, theme_pair, ui_asset, character_sheet, beautify_diagram, anchor.',
+      'f.toolsetProcessing': 'Processing Toolset',
+      'f.toolsetProcessingHint': 'Enable processing tools: remove_background, upscale, vectorize, convert, grid, smart_crop, asset_pack, replace_image_text.',
+      'f.toolsetFrontend': 'Frontend Toolset',
+      'f.toolsetFrontendHint': 'Enable frontend tools: extract_design_tokens, image_to_css_gradient, check_image_contrast, responsive_mockups.',
+      'f.toolsetCreative': 'Creative Toolset',
+      'f.toolsetCreativeHint': 'Enable creative tools: spritesheet, seamless_pattern, sketch_to_image, image_pack.',
       'p.historyLimit': '50',
 
       'f.model': 'FAL Model ID',
@@ -2724,6 +2739,16 @@ window.__ModuleLoader__.load({
       'p.outputDir': 'generated/images',
       'f.historyLimit': '历史记录数量',
       'f.historyLimitHint': '保存在内存历史列表中的最大条目数。',
+      'f.toolsetProfile': '工具集配置档',
+      'f.toolsetProfileHint': '选择注册到对话上下文的工具集：minimal（<= 3个核心工具，节省~8k提示词tokens），all（所有30个工具），或custom。',
+      'f.toolsetDesign': '设计工具集',
+      'f.toolsetDesignHint': '启用设计工具：style_matrix, theme_pair, ui_asset, character_sheet, beautify_diagram, anchor。',
+      'f.toolsetProcessing': '图像处理工具集',
+      'f.toolsetProcessingHint': '启用处理工具：remove_background, upscale, vectorize, convert, grid, smart_crop, asset_pack, replace_image_text。',
+      'f.toolsetFrontend': '前端工具集',
+      'f.toolsetFrontendHint': '启用前端工具：extract_design_tokens, image_to_css_gradient, check_image_contrast, responsive_mockups。',
+      'f.toolsetCreative': '创意工具集',
+      'f.toolsetCreativeHint': '启用创意工具：spritesheet, seamless_pattern, sketch_to_image, image_pack。',
       'p.historyLimit': '50',
 
       'f.model': 'FAL 模型 ID',
@@ -3076,6 +3101,12 @@ window.__ModuleLoader__.load({
         'smart_crop_image',
         'export_asset_pack',
         'generate_ui_asset',
+        'generate_character_sheet',
+        'replace_image_text',
+        'beautify_diagram',
+        'generate_seamless_pattern',
+        'generate_spritesheet',
+        'sketch_to_image',
       ]
 
       for (const toolName of toolviewTools) {

package/lib/config-schema.js

@@ -54,6 +54,40 @@ export const Config = z.object({
     .description('Default aspect ratio (square, landscape_16_9, portrait_9_16, etc.) used when prompt does not specify dimensions.')
     .default('square')
     .volatile(),
+  toolsetProfile: z
+    .string()
+    .description('Which toolset profile to register into conversation context: "minimal" (default, <= 3 core tools, saving ~8,000 prompt tokens), "all" (all 30 tools), or "custom".')
+    .default('minimal')
+    .volatile(),
+  toolsets: z
+    .object({
+      design: z.boolean().default(false).description('Design tools: style_matrix, theme_pair, ui_asset, character_sheet, beautify_diagram, anchor'),
+      processing: z.boolean().default(false).description('Processing tools: remove_background, upscale, vectorize, convert, grid, smart_crop, asset_pack, replace_image_text'),
+      frontend: z.boolean().default(false).description('Frontend tools: extract_design_tokens, image_to_css_gradient, check_image_contrast, responsive_mockups'),
+      creative: z.boolean().default(false).description('Creative tools: spritesheet, seamless_pattern, sketch_to_image, image_pack'),
+    })
+    .default({ design: false, processing: false, frontend: false, creative: false })
+    .volatile(),
+  toolsetDesign: z
+    .boolean()
+    .description('Enable design tools: style_matrix, theme_pair, ui_asset, character_sheet, beautify_diagram, anchor')
+    .default(false)
+    .volatile(),
+  toolsetProcessing: z
+    .boolean()
+    .description('Enable processing tools: remove_background, upscale, vectorize, convert, grid, smart_crop, asset_pack, replace_image_text')
+    .default(false)
+    .volatile(),
+  toolsetFrontend: z
+    .boolean()
+    .description('Enable frontend tools: extract_design_tokens, image_to_css_gradient, check_image_contrast, responsive_mockups')
+    .default(false)
+    .volatile(),
+  toolsetCreative: z
+    .boolean()
+    .description('Enable creative tools: spritesheet, seamless_pattern, sketch_to_image, image_pack')
+    .default(false)
+    .volatile(),
   deliverAs: z
     .string()
     .description('How generated images are returned: "link" keeps them on disk and embeds an inline preview link; "attachment" embeds full image bytes directly in the chat.')

package/lib/index.js

@@ -312,7 +312,10 @@ export function apply(ctx, rawConfig) {
       }
       try {
         const u = new URL(req.url, 'http://localhost')
-        const provider = u.searchParams.get('provider') || config.provider || 'fal'
+        const qProvider = u.searchParams.get('provider')
+        const provider = (typeof qProvider === 'string' && qProvider.trim())
+          || (typeof config?.provider === 'string' && config.provider.trim())
+          || 'fal'
         const deps = {
           fetchImpl: fetch,
           resolveKey: (ref) => resolveApiKey(ctx, ref),

package/lib/providers.js

@@ -378,7 +378,7 @@ export async function blendImagesFal({ fetchImpl, resolveKey, cfg }, { images, w
 /** @internal — direct provider call path for integration tests */
 export async function editImageDirect(deps, job) {
   const providers = makeProviders(deps, job)
-  const providerKey = job.provider || deps.cfg.defaultProvider || 'fal'
+  const providerKey = (typeof job?.provider === 'string' && job.provider.trim()) || (typeof deps?.cfg?.provider === 'string' && deps.cfg.provider.trim()) || (typeof deps?.cfg?.defaultProvider === 'string' && deps.cfg.defaultProvider.trim()) || 'fal'
   const fn = providers[providerKey] || providers.fal || providers.custom
   if (!fn) throw new Error(`Provider "${providerKey}" does not support image editing`)
   return fn(job.seed, job.prompt)
@@ -391,7 +391,7 @@ export async function varyImageDirect(deps, job) {
     ...job,
     strength: job.variationStrength ?? job.strength ?? 0.35,
   })
-  const providerKey = job.provider || deps.cfg.defaultProvider || 'fal'
+  const providerKey = (typeof job?.provider === 'string' && job.provider.trim()) || (typeof deps?.cfg?.provider === 'string' && deps.cfg.provider.trim()) || (typeof deps?.cfg?.defaultProvider === 'string' && deps.cfg.defaultProvider.trim()) || 'fal'
   const fn = providers[providerKey] || providers.fal || providers.custom
   if (!fn) throw new Error(`Provider "${providerKey}" does not support image variations`)
   return fn(job.seed, job.prompt)
@@ -428,7 +428,11 @@ export function toLosslessJson(val) {
 export async function testProviderConnection(deps, providerId) {
   const { fetchImpl = fetch, resolveKey, cfg } = deps
   const start = Date.now()
-  const p = (providerId || cfg.defaultProvider || 'fal').toLowerCase()
+  const rawProvider = (typeof providerId === 'string' && providerId.trim())
+    || (typeof cfg?.provider === 'string' && cfg.provider.trim())
+    || (typeof cfg?.defaultProvider === 'string' && cfg.defaultProvider.trim())
+    || 'fal'
+  const p = rawProvider.toLowerCase()
 
   try {
     if (p === 'fal') {

package/lib/register-tools.js

@@ -1,5 +1,5 @@
-// register-tools.js — orchestrates all image-gen tool registrations (#216).
-// Each tool lives in lib/tools/* and is registered inside a labeled ctx.effect.
+// register-tools.js — orchestrates all image-gen tool registrations (#216, #337).
+// Supports 'minimal' (default: <= 3 core tools), 'all' (all 30 tools), and 'custom' (toggled toolsets).
 
 import { registerGenerationTools } from './tools/generation.js'
 import { registerProcessingTools } from './tools/processing-basic.js'
@@ -20,27 +20,53 @@ import { registerVisionOcrTools } from './tools/vision-ocr.js'
 import { registerDiagramTools } from './tools/diagram.js'
 
 /**
- * Registers every image-gen tool on the host tools service.
+ * Registers every image-gen tool on the host tools service according to toolsetProfile (#337).
  *
  * @param {object} ctx cordis context
  * @param {object} deps shared runtime from apply()
  */
 export function registerAllTools(ctx, deps) {
-  registerGenerationTools(ctx, deps)
-  registerProcessingTools(ctx, deps)
-  registerProcessingAdvancedTools(ctx, deps)
-  registerEditingTools(ctx, deps)
-  registerInspectTools(ctx, deps)
-  registerFrontendTools(ctx, deps)
-  registerSketchTools(ctx, deps)
-  registerSpritesheetTools(ctx, deps)
-  registerPatternTools(ctx, deps)
-  registerResponsiveTools(ctx, deps)
-  registerAnchorTools(ctx, deps)
-  registerUiAssetTools(ctx, deps)
-  registerStyleMatrixTools(ctx, deps)
-  registerThemePairTools(ctx, deps)
-  registerCharacterSheetTools(ctx, deps)
-  registerVisionOcrTools(ctx, deps)
-  registerDiagramTools(ctx, deps)
+  const cfg = typeof deps.live === 'function' ? deps.live() : (deps.config || {})
+  const profile = cfg.toolsetProfile || 'minimal'
+  const isAll = profile === 'all'
+  const sets = cfg.toolsets || {}
+  const design = isAll || Boolean(sets.design || cfg.toolsetDesign)
+  const processing = isAll || Boolean(sets.processing || cfg.toolsetProcessing)
+  const frontend = isAll || Boolean(sets.frontend || cfg.toolsetFrontend)
+  const creative = isAll || Boolean(sets.creative || cfg.toolsetCreative)
+
+  // 1. Core tools: generate_image, edit_image, inspect_image_quality (<= 3 tools in minimal)
+  registerGenerationTools(ctx, deps, { coreOnly: !creative })
+  registerEditingTools(ctx, deps, { coreOnly: !processing })
+  registerInspectTools(ctx, deps, { coreOnly: !processing })
+
+  // 2. Processing toolset
+  if (processing) {
+    registerProcessingTools(ctx, deps)
+    registerProcessingAdvancedTools(ctx, deps)
+    registerVisionOcrTools(ctx, deps)
+  }
+
+  // 3. Design toolset
+  if (design) {
+    registerAnchorTools(ctx, deps)
+    registerUiAssetTools(ctx, deps)
+    registerStyleMatrixTools(ctx, deps)
+    registerThemePairTools(ctx, deps)
+    registerCharacterSheetTools(ctx, deps)
+    registerDiagramTools(ctx, deps)
+  }
+
+  // 4. Frontend toolset
+  if (frontend) {
+    registerFrontendTools(ctx, deps)
+    registerResponsiveTools(ctx, deps)
+  }
+
+  // 5. Creative toolset
+  if (creative) {
+    registerSketchTools(ctx, deps)
+    registerSpritesheetTools(ctx, deps)
+    registerPatternTools(ctx, deps)
+  }
 }

package/lib/security.js

@@ -64,7 +64,8 @@ export function enforceSecurePermissions(filePath) {
   try {
     chmodSync(filePath, 0o600)
     return true
-  } catch {
+  } catch (_err) {
+    /* non-fatal: permission change error */
     return false
   }
 }
@@ -143,7 +144,7 @@ export function extractHostName(hostHeader) {
   try {
     const url = new URL(`http://${trimmed}`)
     return url.hostname.replace(/^\[|\]$/g, '')
-  } catch {
+  } catch (_err) {
     return trimmed.replace(/^\[|\]$/g, '').split(':')[0] || ''
   }
 }
@@ -210,7 +211,7 @@ export function isTrustedLocalRequest(req) {
       if (url.host.toLowerCase() !== host.toLowerCase()) {
         return false
       }
-    } catch {
+    } catch (_err) {
       return false
     }
   }
@@ -226,7 +227,7 @@ export function isTrustedLocalRequest(req) {
       if (!isLoopbackAddress(refererHostName) && !isPrivateLanAddress(refererHostName)) {
         return false
       }
-    } catch {
+    } catch (_err) {
       return false
     }
   }

package/lib/settings-route.js

@@ -79,7 +79,7 @@ export function registerSettingsRoutes(ctx, { live, getSettingsApi, setLiveConfi
       let payload
       try {
         payload = JSON.parse(buf.toString('utf8') || '{}')
-      } catch {
+      } catch (_err) {
         res.writeHead(400, { 'Content-Type': 'application/json' })
         res.end(JSON.stringify({ ok: false, error: 'invalid JSON' }))
         return

package/lib/tools/character-sheet.js

@@ -89,11 +89,7 @@ export function registerCharacterSheetTools(ctx, deps) {
               },
             },
           },
-          render: (result, renderCtx) =>
-            renderToolOutput(result, renderCtx, {
-              title: (res) => `Character Sheet (${res.layout || 'turnaround'}) — ${res.style || 'concept_art'}`,
-              subtitle: (res) => (res.views ? `Views: ${res.views.join(' | ')}` : ''),
-            }),
+          render: (_args, value) => renderToolOutput(value),
         },
         async execute(args, execCtx) {
           const cfg = live.value

package/lib/tools/diagram.js

@@ -85,11 +85,7 @@ export function registerDiagramTools(ctx, deps) {
               },
             },
           },
-          render: (result, renderCtx) =>
-            renderToolOutput(result, renderCtx, {
-              title: (res) => `3D Architecture Diagram — ${res.title || res.style || 'Isometric'}`,
-              subtitle: (res) => (res.detectedNodes?.length ? `Nodes: ${res.detectedNodes.slice(0, 4).join(', ')}` : ''),
-            }),
+          render: (_args, value) => renderToolOutput(value),
         },
         async execute(args, execCtx) {
           const cfg = live?.value || (typeof live === 'function' ? live() : {})

package/lib/tools/editing.js

@@ -16,7 +16,7 @@ import { trackAndAssertLoopGuard } from '../loop-guard.js'
 import { sanitizeErrorAndLogs } from '../security.js'
 
 
-export function registerEditingTools(ctx, deps) {
+export function registerEditingTools(ctx, deps, options = {}) {
   const {
     config,
     live,
@@ -29,41 +29,36 @@ export function registerEditingTools(ctx, deps) {
     ctx.tools.register(
       defineTool({
         name: 'edit_image',
-        description:
-          'Edit an existing image using inpainting, targeted modification, or object replacement. '
-          + 'Describe the desired changes in prompt. '
-          + 'If image is omitted or "latest", automatically resolves the most recent image from the conversation session (#144). '
-          + 'Leverages @goodandready/dsh-vision-bridge for pre-edit composition analysis (#145). '
-          + 'Optionally accepts mask (path or attachment id) and strength (0.1-1.0). Returns safe dual-output (#150).',
+        description: 'Edit an image using inpainting, targeted modification, or object replacement. If image is omitted, uses the latest image from conversation.',
         parameters: {
           prompt: {
             type: 'string',
             required: true,
-            description: 'Detailed description of the modification or edit to perform on the image.',
+            description: 'Description of modification or edit to perform.',
           },
           image: {
             type: 'string',
-            description: 'Path or attachment id of the source image. Defaults to "latest" to auto-resolve from session history.',
+            description: 'Path or attachment ID of source image. Defaults to "latest".',
           },
           mask: {
             type: 'string',
+            description: 'Optional inpaint mask path or attachment ID.',
           },
           mask_image: {
             type: 'string',
-            description: 'Optional path or attachment id of the inpaint mask image (alias for mask).',
-            description: 'Optional path or attachment id of the inpaint mask image.',
+            description: 'Alias for mask.',
           },
           strength: {
             type: 'number',
-            description: 'Denoising / edit strength between 0.1 and 1.0 (default 0.75 for edits, 0.9 for mask inpainting).',
+            description: 'Edit strength between 0.1 and 1.0 (default 0.75).',
           },
           output_name: {
             type: 'string',
-            description: 'Optional file name stem for the saved edited image.',
+            description: 'Optional file name stem for edited image.',
           },
           output_dir: {
             type: 'string',
-            description: 'Optional custom directory to write edited image into.',
+            description: 'Optional custom directory for edited image.',
           },
         },
         output: {
@@ -165,6 +160,7 @@ export function registerEditingTools(ctx, deps) {
       }),
     )
   }, 'dsh-image-gen: tool edit_image')
+  if (!options.coreOnly) {
   ctx.effect(() => {
     ctx.tools.register(
       defineTool({
@@ -450,5 +446,5 @@ export function registerEditingTools(ctx, deps) {
       }),
     )
   }, 'dsh-image-gen: tool remix_image')
-
+  }
 }

package/lib/tools/generation.js

@@ -1,22 +1,4 @@
 import { registerGenerationPackTool } from './generation-pack.js'
-
-/** Run an array of async task functions with a concurrency cap */
-async function asyncPool(tasks, concurrency = 3) {
-  const results = new Array(tasks.length)
-  let nextIdx = 0
-  async function worker() {
-    while (nextIdx < tasks.length) {
-      const idx = nextIdx++
-      results[idx] = await tasks[idx]()
-    }
-  }
-  const workers = Array.from({ length: Math.min(concurrency, tasks.length) }, () => worker())
-  await Promise.all(workers)
-  return results
-}
-
-// generation — image-gen tools (generate_image, generate_image_pack). Extracted from apply() (#216).
-
 import { defineTool } from '@deepseek-ai/dsh-tools'
 import path from 'node:path'
 import { mkdir, writeFile } from 'node:fs/promises'
@@ -53,8 +35,24 @@ import {
   cachedResult,
 } from '../history.js'
 
+// generation — image-gen tools (generate_image, generate_image_pack). Extracted from apply() (#216).
 
-export function registerGenerationTools(ctx, deps) {
+/** Run an array of async task functions with a concurrency cap */
+async function asyncPool(tasks, concurrency = 3) {
+  const results = new Array(tasks.length)
+  let nextIdx = 0
+  async function worker() {
+    while (nextIdx < tasks.length) {
+      const idx = nextIdx++
+      results[idx] = await tasks[idx]()
+    }
+  }
+  const workers = Array.from({ length: Math.min(concurrency, tasks.length) }, () => worker())
+  await Promise.all(workers)
+  return results
+}
+
+export function registerGenerationTools(ctx, deps, options = {}) {
   const {
     config,
     live,
@@ -66,17 +64,12 @@ export function registerGenerationTools(ctx, deps) {
     ctx.tools.register(
     defineTool({
       name: 'generate_image',
-      description:
-        'Generate an image with the configured image provider. '
-        + 'Saves the image to the session workspace and shows it in the conversation. '
-        + 'Depending on how the deployment is configured the result carries either the image itself or a link to it; '
-        + 'when you only get a link, answer from the prompt and the link rather than claiming to see the picture. '
-        + 'Use for any text-to-image request. Pass count (1-4) to generate several variations in one call; cost scales with count (default 1).',
+      description: 'Generate an image from prompt. Saves the image to workspace and conversation. Pass count (1-4) for variations.',
       parameters: {
         prompt: {
           type: 'string',
           required: true,
-          description: 'Detailed description of the image to generate (subject, style, lighting, composition, colors).',
+          description: 'Detailed description of the image to generate.',
         },
         image_size: {
           type: 'string',
@@ -85,7 +78,7 @@ export function registerGenerationTools(ctx, deps) {
         aspect_ratio: {
           type: 'string',
           enum: ['1:1', '16:9', '9:16', '4:3', '3:4', '3:2', '2:3'],
-          description: 'Optional aspect ratio; overrides image_size when both are given. Sent as width/height to providers that accept pixels.',
+          description: 'Optional aspect ratio (e.g. 16:9, 1:1), overrides image_size.',
         },
         seed: {
           type: 'integer',
@@ -98,11 +91,11 @@ export function registerGenerationTools(ctx, deps) {
         },
         output_name: {
           type: 'string',
-          description: 'Optional file name stem for the saved image (defaults to a slug of the prompt).',
+          description: 'Optional file name stem for the saved image.',
         },
         output_dir: {
           type: 'string',
-          description: 'Optional custom directory to write images into (relative to session cwd or absolute). Defaults to outputDir from settings.',
+          description: 'Optional custom directory to write images into.',
         },
         style_preset: {
           type: 'string',
@@ -111,11 +104,11 @@ export function registerGenerationTools(ctx, deps) {
         palette_colors: {
           type: 'array',
           items: { type: 'string' },
-          description: 'Optional array of hex color codes (#1e1b4b) to constrain and harmonize the color palette.',
+          description: 'Optional hex color codes (#1e1b4b) to harmonize palette.',
         },
         count: {
           type: 'integer',
-          description: 'Number of variations to generate in one call, 1-4 (default 1). Cost scales with count.',
+          description: 'Variations count (1-4, default 1).',
         },
         prompts: {
           type: 'array',
@@ -125,60 +118,60 @@ export function registerGenerationTools(ctx, deps) {
               { type: 'object', additionalProperties: false, properties: { text: { type: 'string' } } },
             ],
           },
-          description: 'Optional list of prompts (strings or {text}); one image is generated per prompt. When set, overrides count and the single prompt.',
+          description: 'Optional list of prompts for batch generation.',
         },
         negative_prompt: {
           type: 'string',
-          description: 'Optional text describing what NOT to draw; sent to providers that support it (ignored otherwise).',
+          description: 'Optional text describing what NOT to draw.',
         },
         guidance_scale: {
           type: 'number',
-          description: 'Optional prompt adherence (e.g. 1-20); sent to providers that support it (ignored otherwise).',
+          description: 'Optional prompt adherence (1-20).',
         },
         quality: {
           type: 'string',
           enum: ['auto', 'low', 'medium', 'high'],
-          description: 'Optional quality for providers that support it (seedream, gemini). Ignored otherwise.',
+          description: 'Optional quality for supported providers.',
         },
         style: {
           type: 'string',
-          description: 'Optional style preset for providers that support it (seedream, gemini). Ignored otherwise.',
+          description: 'Optional style preset for supported providers.',
         },
         source_image: {
           type: 'string',
-          description: 'Optional path to an image file or an attachment id (sha256:...) to edit instead of drawing from scratch. Only providers that support image editing accept it; others refuse with a clear reason.',
+          description: 'Optional source image path or attachment ID for img2img.',
         },
         mask: {
           type: 'string',
-          description: 'Optional path or attachment id of a mask image (same size as source) to restrict the edit to a region. Only used when source_image is set and the provider supports masks.',
+          description: 'Optional inpaint mask path or attachment ID.',
         },
         strength: {
           type: 'number',
-          description: 'Optional edit strength (0-1) for providers that accept it; higher keeps more of the original.',
+          description: 'Optional edit strength (0-1).',
         },
         quality_gate: {
           type: 'boolean',
-          description: 'Optional override to enable/disable automated quality gate and defect re-rolling for this call.',
+          description: 'Optional automated quality gate override.',
         },
         force: {
           type: 'boolean',
-          description: 'Optional flag to bypass content-addressed cache and force a new API generation.',
+          description: 'Bypass cache and force new generation.',
         },
         reference_image: {
           type: 'string',
-          description: 'Optional reference image (URL, path, or sha256:...) for character or style consistency.',
+          description: 'Optional reference image path or URL for consistency.',
         },
         reference_strength: {
           type: 'number',
-          description: 'Optional strength of reference anchor influence (0.1 to 1.0).',
+          description: 'Strength of reference influence (0.1-1.0).',
         },
         face_reference: {
           type: 'string',
-          description: 'Portrait reference image (URL, local path, or attachment id) for facial identity preservation via FaceID / IP-Adapter (#183).',
+          description: 'Portrait reference image for facial identity preservation.',
         },
         face_strength: {
           type: 'number',
-          description: 'Facial identity similarity weight between 0.1 and 1.0 (default: 0.75).',
+          description: 'Facial identity similarity weight (0.1-1.0).',
         },
       },
       output: {
@@ -344,7 +337,7 @@ export function registerGenerationTools(ctx, deps) {
       // Subscriptions service is optional: without it, subscription providers
       // gracefully decline while other providers continue functioning.
         let subscriptionImages
-        try { subscriptionImages = ctx.get && ctx.get('subscriptionImages') } catch { subscriptionImages = undefined }
+        try { subscriptionImages = ctx.get && ctx.get('subscriptionImages') } catch (_err) { subscriptionImages = undefined }
 
         const source = args.source_image ? await resolveSource(ctx, exec, args.source_image) : undefined
         const mask = args.mask ? await resolveSource(ctx, exec, args.mask) : undefined
@@ -358,7 +351,8 @@ export function registerGenerationTools(ctx, deps) {
         if (faceRefInput) {
           try {
             resolvedFaceRef = await resolveSource(ctx, exec, faceRefInput)
-          } catch {
+          } catch (_err) {
+            /* non-fatal: face_reference resolve fallback */
             resolvedFaceRef = { url: faceRefInput }
           }
           const facePlan = buildFaceConsistencyPrompt({
@@ -651,5 +645,7 @@ export function registerGenerationTools(ctx, deps) {
     }),
   )
   }, 'dsh-image-gen: tool generate_image')
-  registerGenerationPackTool(ctx, deps)
+  if (!options.coreOnly) {
+    registerGenerationPackTool(ctx, deps)
+  }
 }

package/lib/tools/inspect.js

@@ -7,12 +7,13 @@ import {
   estimateSharpnessAndVariance,
 } from '../providers.js'
 
-export function registerInspectTools(ctx, deps) {
+export function registerInspectTools(ctx, deps, options = {}) {
   const { resolveSource } = deps
-  ctx.effect(() => {
-    ctx.tools.register(
-      defineTool({
-        name: 'compare_images',
+  if (!options.coreOnly) {
+    ctx.effect(() => {
+      ctx.tools.register(
+        defineTool({
+          name: 'compare_images',
         description: 'Compare two images (paths or attachment ids) and report the fraction of differing pixels. Use to check how much an edit changed the original.',
         parameters: {
           image_a: { type: 'string', required: true, description: 'Path or attachment id of the first image.' },
@@ -37,6 +38,7 @@ export function registerInspectTools(ctx, deps) {
       }),
     )
   }, 'dsh-image-gen: tool compare_images')
+  }
   ctx.effect(() => {
     ctx.tools.register(
       defineTool({

package/lib/tools/style-matrix.js

@@ -126,7 +126,7 @@ export function registerStyleMatrixTools(ctx, deps) {
 
           const provider = PROVIDER_KEYS.includes(cfg.provider) ? cfg.provider : 'fal'
           let subscriptionImages
-          try { subscriptionImages = ctx.get && ctx.get('subscriptionImages') } catch { subscriptionImages = undefined }
+          try { subscriptionImages = ctx.get && ctx.get('subscriptionImages') } catch (_err) { subscriptionImages = undefined }
 
           const chain = resolveFallbackChain(provider, cfg.fallbackProviders, PROVIDER_KEYS)
           const quadrantIds = ['A', 'B', 'C', 'D']

package/lib/tools/ui-asset.js

@@ -145,7 +145,7 @@ export function registerUiAssetTools(ctx, deps) {
 
           const provider = PROVIDER_KEYS.includes(cfg.provider) ? cfg.provider : 'fal'
           let subscriptionImages
-          try { subscriptionImages = ctx.get && ctx.get('subscriptionImages') } catch { subscriptionImages = undefined }
+          try { subscriptionImages = ctx.get && ctx.get('subscriptionImages') } catch (_err) { subscriptionImages = undefined }
 
           const providers = makeProviders(
             { fetchImpl: fetch, resolveKey: (ref) => resolveApiKey(ctx, ref), cfg, subscriptionImages },

package/lib/tools/vision-ocr.js

@@ -39,7 +39,7 @@ export function registerVisionOcrTools(ctx, deps) {
           },
           replacements: {
             type: 'array',
-            description: 'Array of text replacements: [{ find: "Old Text", replace: "Новый Текст", bbox: [x1,y1,x2,y2] }].',
+            description: 'Array of text replacements: [{ find: "Old Text", replace: "New Text", bbox: [x1,y1,x2,y2] }].',
             items: {
               type: 'object',
               additionalProperties: true,
@@ -109,11 +109,7 @@ export function registerVisionOcrTools(ctx, deps) {
               },
             },
           },
-          render: (result, renderCtx) =>
-            renderToolOutput(result, renderCtx, {
-              title: (res) => `Text Replaced (${res.replacedCount || 0} inscriptions)`,
-              subtitle: (res) => (res.bboxes?.length ? `Detected regions: ${res.bboxes.length}` : ''),
-            }),
+          render: (_args, value) => renderToolOutput(value),
         },
         async execute(args, execCtx) {
           const cfg = live?.value || (typeof live === 'function' ? live() : {})
@@ -145,8 +141,8 @@ export function registerVisionOcrTools(ctx, deps) {
                   if (gRes?.bbox && gRes.bbox.length === 4) {
                     bbox = gRes.bbox
                   }
-                } catch {
-                  // non-fatal vision_ground fallback
+                } catch (_err) {
+                  /* non-fatal: vision_ground fallback */
                 }
               }
             }
@@ -168,7 +164,7 @@ export function registerVisionOcrTools(ctx, deps) {
             const defaultBox = [150, 420, 850, 520]
             bboxes.push(defaultBox)
             overlayItems.push({
-              text: args.target_language === 'ru' ? 'Заголовок' : 'Localized Text',
+              text: 'Localized Text',
               bbox: defaultBox,
               color: args.font_color || '#FFFFFF',
             })
@@ -216,8 +212,8 @@ export function registerVisionOcrTools(ctx, deps) {
             )
             inpaintedBytes = inpaintResult.bytes
             inpaintedUrl = inpaintResult.url
-          } catch {
-            // If inpaint provider unavailable, keep source bytes and proceed with overlay
+          } catch (_err) {
+            /* non-fatal: inpaint provider unavailable; use source bytes */
             inpaintedBytes = source.bytes
           }
 

package/lib/updater.js

@@ -1,5 +1,5 @@
 import { spawn } from 'node:child_process'
-import { existsSync, readFileSync } from 'node:fs'
+import { existsSync, readFileSync, unlinkSync, statSync } from 'node:fs'
 import { readFile } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { basename, dirname, isAbsolute, resolve } from 'node:path'
@@ -10,6 +10,60 @@ import { isLoopbackAddress, isPrivateLanAddress, extractHostName } from './secur
  * Implements the unified DSH plugin updater specification.
  */
 
+
+export function isPidAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return false
+  try {
+    process.kill(pid, 0)
+    return true
+  } catch (err) {
+    return err?.code === 'EPERM'
+  }
+}
+
+export function checkAndCleanProfileLock(profileDir) {
+  if (!profileDir) return { locked: false }
+  const lockPath = resolve(profileDir, 'package.json.lock')
+  if (!existsSync(lockPath)) return { locked: false }
+  let pid = null
+  try {
+    const raw = readFileSync(lockPath, 'utf8').trim()
+    try {
+      const parsed = JSON.parse(raw)
+      pid = parsed?.pid ?? Number(raw)
+    } catch (_e) {
+      pid = parseInt(raw, 10)
+    }
+  } catch (_err) {
+    /* lock unreadable */
+  }
+
+  if (Number.isInteger(pid) && pid > 0) {
+    if (isPidAlive(pid)) {
+      return { locked: true, pid }
+    }
+    // Stale lock: PID is not running
+    try {
+      unlinkSync(lockPath)
+    } catch (_err) {
+      /* non-fatal */
+    }
+    return { locked: false, staleCleaned: true, pid }
+  }
+
+  // Lockfile without valid PID: check age (> 10 min)
+  try {
+    const stat = statSync(lockPath)
+    if (Date.now() - stat.mtimeMs > 10 * 60_000) {
+      unlinkSync(lockPath)
+      return { locked: false, staleCleaned: true }
+    }
+    return { locked: true, pid: null }
+  } catch (_err) {
+    return { locked: false }
+  }
+}
+
 const UPDATE_HEADER = 'x-dsh-plugin-update'
 const UPDATE_TIMEOUT_MS = 10 * 60_000
 const VERSION_CACHE_MS = 5 * 60_000
@@ -39,7 +93,7 @@ export function isTrustedUpdateRequest(request) {
       (isLoopbackAddress(hostName) || isPrivateLanAddress(hostName)) &&
       url.host.toLowerCase() === host.toLowerCase()
     )
-  } catch {
+  } catch (_err) {
     return false
   }
 }
@@ -213,7 +267,6 @@ async function installExact(target, packageSpec, options) {
         '--profile',
         target.profileName,
         'add',
-        '--config.minimumReleaseAge=0',
         packageSpec,
         `--registry=${options.registry ?? 'https://registry.npmjs.org/'}`,
       ],
@@ -232,9 +285,15 @@ async function installExact(target, packageSpec, options) {
       detail = (detail + String(chunk)).slice(-4000)
     })
     const timer = setTimeout(() => {
-      child.kill()
+      try {
+        child.kill('SIGTERM')
+        setTimeout(() => {
+          try { child.kill('SIGKILL') } catch (_err) {}
+          checkAndCleanProfileLock(target.profileDir)
+        }, 1500)
+      } catch (_err) {}
       reject(new Error('Update timed out; use the normal DSH update flow.'))
-    }, UPDATE_TIMEOUT_MS)
+    }, options.timeoutMs ?? UPDATE_TIMEOUT_MS)
     child.once('error', (error) => {
       clearTimeout(timer)
       reject(error)
@@ -290,6 +349,11 @@ export function registerPluginUpdater(ctx, options) {
           json(response, 409, { error: 'This plugin is already updating.' })
           return
         }
+        const lockState = checkAndCleanProfileLock(target.profileDir)
+        if (lockState.locked) {
+          json(response, 409, { error: `Another package installation is currently in progress${lockState.pid ? ` (PID ${lockState.pid})` : ''}.` })
+          return
+        }
         installing = true
         try {
           const before = await status(options, target)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goodandready/dsh-image-gen",
-  "version": "0.11.12",
-  "description": "Image generation for DeepSeek Harness: a generate_image tool with pluggable providers — the FAL queue, any OpenAI-compatible images API, or a ChatGPT/Grok subscription with no API key at all. The picture is shown inline in the conversation; the model receives either a link (works with any chat model) or the image itself (needs dsh-vision-bridge or a vision-capable model).",
+  "version": "0.11.14",
+  "description": "Image generation for DeepSeek Harness: a generate_image tool with pluggable providers \u2014 the FAL queue, any OpenAI-compatible images API, or a ChatGPT/Grok subscription with no API key at all. The picture is shown inline in the conversation; the model receives either a link (works with any chat model) or the image itself (needs dsh-vision-bridge or a vision-capable model).",
   "keywords": [
     "deepseek-harness",
     "dsh",
@@ -69,7 +69,7 @@
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "scripts": {
-    "test": "node scripts/build-client.mjs --check && node --check lib/client.js && node --test test/*.test.mjs",
+    "test": "node scripts/build-client.mjs --check && node --check lib/client.js && node --import ./test/_setup.mjs --test test/*.test.mjs",
     "build:client": "node scripts/build-client.mjs",
     "publish:github": "bash scripts/publish-github.sh",
     "build:client:check": "node scripts/build-client.mjs --check"