dsh-image-gen 0.2.4 → 0.2.6

package/lib/types/client/gallery-store.d.ts

@@ -12,9 +12,17 @@ export interface GalleryItem {
     provider: ImageProvider;
     model: string;
     createdAt: number;
-    aspectRatio?: string;
-    imageSize?: string;
-    output?: string;
+    aspectRatio?: string | undefined;
+    imageSize?: string | undefined;
+    output?: string | undefined;
+    /** Workflow seed reported by the ComfyUI provider. Optional so records written by older versions stay readable; the object store is schemaless, so no IndexedDB version bump is needed. */
+    seed?: number | undefined;
+    /** Saved file path on workspace disk if savedTo was returned */
+    savedTo?: string | undefined;
+    /** Whether this item is marked as favorite */
+    isFavorite?: boolean | undefined;
+    /** Custom tags or collection markers */
+    tags?: string[] | undefined;
 }
 type GalleryListener = () => void;
 /**
@@ -24,6 +32,7 @@ export declare function subscribeGallery(listener: GalleryListener): () => void;
 /**
  * Save or update a gallery record by attachmentId.
  * Skipped if the item was previously deleted (tombstoned).
+ * Preserves existing isFavorite, tags, and original createdAt on re-renders.
  */
 export declare function saveGalleryItem(item: Omit<GalleryItem, 'createdAt'> & {
     createdAt?: number;
@@ -32,10 +41,19 @@ export declare function saveGalleryItem(item: Omit<GalleryItem, 'createdAt'> & {
  * Retrieve all gallery records sorted by createdAt descending.
  */
 export declare function getGalleryItems(): Promise<GalleryItem[]>;
+/**
+ * Toggle favorite status of a gallery item.
+ * Returns the new favorite status (true if favorited, false if unfavorited).
+ */
+export declare function toggleFavoriteGalleryItem(id: string): Promise<boolean>;
 /**
  * Delete a single gallery record by ID and record a tombstone.
  */
 export declare function deleteGalleryItem(id: string): Promise<void>;
+/**
+ * Bulk delete multiple gallery records by IDs and record tombstones in a single transaction.
+ */
+export declare function bulkDeleteGalleryItems(ids: string[]): Promise<void>;
 /**
  * Clear all gallery records and reset tombstones.
  */

package/lib/types/client/gallery-view.d.ts

@@ -1,6 +1,7 @@
 /**
- * Native Workspace Gallery View Component for DSH `conversation.view` slot.
- * Fully i18n-reactive (Chinese & English).
+ * Native Workspace Gallery & Studio View Component for DSH `conversation.view` slot.
+ * Fully i18n-reactive (Chinese & English) with modular tabs, multi-dimensional filters,
+ * responsive image grid, and placeholder routes.
  */
 import { type FC } from 'react';
 export interface LocaleService {
@@ -9,22 +10,38 @@ export interface LocaleService {
     };
     subscribe(fn: () => void): () => void;
 }
+export type TabKey = 'gallery' | 'studio' | 'favorites' | 'compare' | 'tasks';
+export type SortKey = 'newest' | 'oldest';
 declare const DICT: {
     readonly zh: {
-        readonly totalCount: "共 {count} 张生成图片";
-        readonly searchPlaceholder: "搜索 Prompt 关键词…";
-        readonly filterAll: "全部厂商";
+        readonly tabGallery: "图库";
+        readonly tabStudio: "工作台";
+        readonly tabFavorites: "收藏";
+        readonly tabCompare: "对比";
+        readonly tabTasks: "任务";
+        readonly filterAllProviders: "全部提供商";
         readonly filterGoogle: "Google Gemini";
         readonly filterOpenAI: "OpenAI / 中转站";
         readonly filterSeedream: "字节 Seedream";
         readonly filterDashScope: "阿里 DashScope";
+        readonly filterComfyUI: "本地 ComfyUI";
+        readonly filterAllModels: "全部模型";
+        readonly filterAllRatios: "全部比例";
+        readonly searchPlaceholder: "搜索 Prompt、标签…";
+        readonly sortNewest: "最新生成";
+        readonly sortOldest: "最早生成";
+        readonly totalCount: "共 {count} 张生成图片";
         readonly emptyTitle: "暂无生图记录";
         readonly emptyDesc: "在对话中让 Agent 生图后，生成的图片会自动收录到这里。";
+        readonly favEmptyTitle: "暂无收藏图片";
+        readonly favEmptyDesc: "在图库中点击卡片右下角的 ♡ 按钮，即可将喜爱的图片收录到这里。";
         readonly noMatchTitle: "未找到匹配结果";
-        readonly noMatchDesc: "尝试更换搜索关键词或选择其他厂商。";
+        readonly noMatchDesc: "尝试更换搜索关键词或调整筛选条件。";
         readonly copiedPrompt: "已复制 Prompt";
         readonly copiedImage: "已复制图片";
         readonly copyFailed: "复制失败";
+        readonly favoriteAdded: "已添加到收藏";
+        readonly favoriteRemoved: "已取消收藏";
         readonly preview: "查看大图";
         readonly download: "下载图片";
         readonly copyImg: "复制图片";
@@ -35,22 +52,68 @@ declare const DICT: {
         readonly model: "模型";
         readonly prompt: "Prompt";
         readonly close: "关闭 (Esc)";
+        readonly prevImage: "上一张 (←)";
+        readonly nextImage: "下一张 (→)";
+        readonly manage: "批量删除";
+        readonly exitManage: "退出选择";
+        readonly selectedCount: "已选 {n} 项";
+        readonly selectAll: "全选";
+        readonly invertSelect: "反选";
+        readonly clearSelect: "清空";
+        readonly batchDelete: "批量删除";
+        readonly batchDeleteTitle: "确认批量删除选中的 {count} 张图片？";
+        readonly batchDeleteTitleSingle: "确认从画廊中删除这张图片？";
+        readonly batchDeleteDesc: "将从画廊历史记录中移除所选图片。";
+        readonly deleteWorkspaceFilesOpt: "同时清理工作区磁盘物理文件（不可恢复）";
+        readonly cancel: "取消";
+        readonly confirmBatchDelete: "确认删除 ({count})";
+        readonly confirmDeleteSingle: "确认删除";
+        readonly batchDeletedToast: "已删除 {count} 张图片";
+        readonly batchDeletedWithFilesToast: "已删除 {count} 张图片，并清理了 {files} 个工作区文件";
+        readonly deleteFailedFileLocked: "已删除 {count} 张图片，但有 {files} 个文件因被系统占用未能删除";
+        readonly deleteFailedDatabase: "删除失败：本地数据库操作异常";
+        readonly justNow: "刚刚";
+        readonly minutesAgo: "{n} 分钟前";
+        readonly hoursAgo: "{n} 小时前";
+        readonly daysAgo: "{n} 天前";
+        readonly studioTitle: "AI 图像工作台 (Studio)";
+        readonly studioDesc: "工作台模块正在紧锣密鼓开发中。在此你将体验大图精修、变体生成 (Variations)、参数重调并一键将生成结果无缝插回 DSH 正在进行的对话。";
+        readonly studioTip: "💡 提示：目前你可以在“图库”中点击任意图片，在弹窗中进行查看、复制与下载。";
+        readonly compareTitle: "多模型横向对比 (Compare)";
+        readonly compareDesc: "支持单个 Prompt 一键同时调度 Gemini、Seedream、DashScope 及本地 ComfyUI 模型并排生成，直观横评画质与细节。";
+        readonly tasksTitle: "异步任务队列 (Tasks)";
+        readonly tasksDesc: "集中管理后台批量生图、多模型并发生成与本地 ComfyUI 耗时任务。支持状态追踪、失败重试与执行耗时分析。";
+        readonly comingSoonBadge: "即将推出";
     };
     readonly en: {
-        readonly totalCount: "{count} images total";
-        readonly searchPlaceholder: "Search prompt keywords…";
-        readonly filterAll: "All Providers";
+        readonly tabGallery: "Gallery";
+        readonly tabStudio: "Studio";
+        readonly tabFavorites: "Favorites";
+        readonly tabCompare: "Compare";
+        readonly tabTasks: "Tasks";
+        readonly filterAllProviders: "All Providers";
         readonly filterGoogle: "Google Gemini";
         readonly filterOpenAI: "OpenAI / Relay";
         readonly filterSeedream: "ByteDance Seedream";
         readonly filterDashScope: "Aliyun DashScope";
+        readonly filterComfyUI: "Local ComfyUI";
+        readonly filterAllModels: "All Models";
+        readonly filterAllRatios: "All Ratios";
+        readonly searchPlaceholder: "Search prompt, tags…";
+        readonly sortNewest: "Newest first";
+        readonly sortOldest: "Oldest first";
+        readonly totalCount: "{count} images total";
         readonly emptyTitle: "No images generated yet";
         readonly emptyDesc: "Images generated during conversations will automatically appear here.";
+        readonly favEmptyTitle: "No favorite images yet";
+        readonly favEmptyDesc: "Click the ♡ button on any card in the gallery to collect your favorite images here.";
         readonly noMatchTitle: "No matching images";
-        readonly noMatchDesc: "Try a different search keyword or provider filter.";
+        readonly noMatchDesc: "Try a different search keyword or adjust filter criteria.";
         readonly copiedPrompt: "Prompt copied";
         readonly copiedImage: "Image copied";
         readonly copyFailed: "Copy failed";
+        readonly favoriteAdded: "Added to favorites";
+        readonly favoriteRemoved: "Removed from favorites";
         readonly preview: "Full Preview";
         readonly download: "Download";
         readonly copyImg: "Copy Image";
@@ -61,6 +124,38 @@ declare const DICT: {
         readonly model: "Model";
         readonly prompt: "Prompt";
         readonly close: "Close (Esc)";
+        readonly prevImage: "Previous (←)";
+        readonly nextImage: "Next (→)";
+        readonly manage: "Batch Delete";
+        readonly exitManage: "Done";
+        readonly selectedCount: "{n} selected";
+        readonly selectAll: "Select All";
+        readonly invertSelect: "Invert";
+        readonly clearSelect: "Clear";
+        readonly batchDelete: "Batch Delete";
+        readonly batchDeleteTitle: "Delete {count} selected images?";
+        readonly batchDeleteTitleSingle: "Delete this image from gallery?";
+        readonly batchDeleteDesc: "These images will be removed from your gallery history.";
+        readonly deleteWorkspaceFilesOpt: "Also delete files from workspace disk (cannot be undone)";
+        readonly cancel: "Cancel";
+        readonly confirmBatchDelete: "Delete ({count})";
+        readonly confirmDeleteSingle: "Delete";
+        readonly batchDeletedToast: "Deleted {count} images";
+        readonly batchDeletedWithFilesToast: "Deleted {count} images and cleaned {files} workspace files";
+        readonly deleteFailedFileLocked: "Deleted {count} images, but {files} files could not be deleted (busy/locked)";
+        readonly deleteFailedDatabase: "Failed to delete: local database error";
+        readonly justNow: "Just now";
+        readonly minutesAgo: "{n}m ago";
+        readonly hoursAgo: "{n}h ago";
+        readonly daysAgo: "{n}d ago";
+        readonly studioTitle: "AI Image Studio";
+        readonly studioDesc: "Studio workbench is under active development. Fine-tune prompts, generate variations (2x/4x), and inject images directly into DSH chat.";
+        readonly studioTip: "💡 Tip: You can currently click any image in the Gallery to preview, copy, or download it.";
+        readonly compareTitle: "Model Comparison (Compare)";
+        readonly compareDesc: "Side-by-side multi-model benchmarking coming soon. Test Gemini, Seedream, DashScope, and ComfyUI with a single prompt.";
+        readonly tasksTitle: "Task Queue (Tasks)";
+        readonly tasksDesc: "Centralized view for batch generation, asynchronous ComfyUI runs, live progress tracking, and retry controls.";
+        readonly comingSoonBadge: "Coming Soon";
     };
 };
 export type DictKey = keyof typeof DICT.zh;

package/lib/types/client/image-result-node.d.ts

@@ -8,6 +8,8 @@ export interface ImageResultPresentation {
     readonly model: string;
     readonly output: string;
     readonly savedTo?: string;
+    /** Workflow seed reported by the ComfyUI provider, when available. */
+    readonly seed?: number;
 }
 interface ImageResultState {
     readonly turn: number;
@@ -46,8 +48,23 @@ interface ConversationNodeDefinitionLike<State> {
     }, match: MatchLike): State;
     buildViewNode(context: ContextLike<State>): Record<string, unknown> | null;
 }
-/** One image result row per Turn, re-anchored to Turn end after the final answer settles. */
+/** Options controlling where the artifact anchors as its Turn progresses. */
+export interface ImageResultNodeOptions {
+    /**
+     * Whether the host transcript view folds completed-Turn process content
+     * (Compact mode). Omission or a thrown/unavailable read falls back to
+     * Compact-safe anchoring, which keeps the artifact always visible.
+     */
+    readonly isCompactTranscript?: () => boolean;
+}
+/** Default definition: unknown transcript mode falls back to Compact-safe anchoring. */
 export declare const imageResultDefinition: ConversationNodeDefinitionLike<ImageResultState>;
+/**
+ * One image result row per Turn, anchored at its own tool/result position while
+ * the Turn runs, then optionally re-anchored beside the final answer once the
+ * Turn closes (only needed under the folding Compact transcript view).
+ */
+export declare function createImageResultDefinition(options?: ImageResultNodeOptions): ConversationNodeDefinitionLike<ImageResultState>;
 /** Parse the plugin-owned durable presentation metadata from a Tool result event. */
 export declare function imageResultFromMeta(value: unknown): ImageResultPresentation | undefined;
 export {};

package/lib/types/client/index.d.ts

@@ -1,7 +1,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { SettingsScope } from '@deepseek-ai/dsh-client-runtime/client';
 import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
-import { type ImageProvider } from '../shared.js';
+import { type ComfyUIWorkflowEntry, type ImageProvider } from '../shared.js';
 import { type LocaleService } from './gallery-view.js';
 import { type ImageResultPresentation } from './image-result-node.js';
 type Provider = ImageProvider;
@@ -16,6 +16,8 @@ interface ImageSettings {
     dashscopeEndpoint?: string;
     dashscopeModel?: string;
     comfyuiBaseURL?: string;
+    comfyuiWorkflows?: ComfyUIWorkflowEntry[];
+    comfyuiActiveWorkflow?: string;
     comfyuiWorkflowJson?: string;
     comfyuiWorkflowName?: string;
     comfyuiTimeoutMs?: number;

package/lib/types/comfyui-workflow.d.ts

@@ -1,8 +1,19 @@
 export declare const COMFYUI_PROMPT_PLACEHOLDER = "{{prompt}}";
 export declare const COMFYUI_SEED_PLACEHOLDER = "{{seed}}";
+export declare const COMFYUI_IMAGE_PLACEHOLDER = "{{image}}";
 type JsonRecord = Record<string, unknown>;
 /** Validate imported JSON without exposing workflow graph details to callers. */
 export declare function validateComfyUIWorkflowJson(workflowJson: string): void;
-/** Parse, clone, and inject one prompt plus an optional randomized seed. */
-export declare function prepareComfyUIWorkflow(workflowJson: string, prompt: string, seed?: number): JsonRecord;
+/**
+ * Parse, clone, and inject one prompt plus an optional randomized seed.
+ *
+ * Prompt and seed placeholders are replaced inside any string so existing
+ * workflows that embed them in longer text keep working. The image
+ * placeholder is stricter: it only matches a dedicated `inputs.image` field
+ * whose value is exactly the placeholder, and at most one may exist, because
+ * the field must carry a single uploaded file name.
+ */
+export declare function prepareComfyUIWorkflow(workflowJson: string, prompt: string, seed?: number, image?: string): JsonRecord;
+/** Random seed in the 32-bit range ComfyUI samplers accept. */
+export declare function randomSeed(): number;
 export {};

package/lib/types/comfyui.d.ts

@@ -1,15 +1,32 @@
-/** ComfyUI text-to-image adapter using an imported API-format workflow. */
+/** ComfyUI text-to-image and image-to-image adapters using an imported API-format workflow. */
 import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
 export interface GeneratedComfyUIImage {
     data: Uint8Array;
     mediaType: ImageMediaType;
+    /** Concrete seed injected into the workflow, surfaced for provenance metadata. */
+    seed: number;
 }
-/** Run one ComfyUI workflow and return its first final image. */
-export declare function generateComfyUIImage(input: {
+/** Source image bytes a ComfyUI workflow accepts through its image input. */
+export interface ComfyUISourceImage {
+    data: Uint8Array;
+    mediaType: ImageMediaType;
+}
+interface ComfyUIJobInput {
     baseURL: string;
+    timeoutMs: number;
+    signal: AbortSignal;
+}
+/** Run one ComfyUI text-to-image workflow and return its first final image. */
+export declare function generateComfyUIImage(input: ComfyUIJobInput & {
     workflowJson: string;
     prompt: string;
-    timeoutMs: number;
     maxBytes: number;
-    signal: AbortSignal;
 }): Promise<GeneratedComfyUIImage>;
+/** Upload one source image, run the workflow, and return its first final image. */
+export declare function editComfyUIImage(input: ComfyUIJobInput & {
+    workflowJson: string;
+    prompt: string;
+    sourceImage: ComfyUISourceImage;
+    maxBytes: number;
+}): Promise<GeneratedComfyUIImage>;
+export {};

package/lib/types/config.d.ts

@@ -1,7 +1,7 @@
 /** User-facing configuration for supported image providers. */
 import z from '@deepseek-ai/schemastery';
-import { DEFAULT_DASHSCOPE_ENDPOINT, DEFAULT_DASHSCOPE_MODEL, DEFAULT_COMFYUI_BASE_URL, DEFAULT_COMFYUI_TIMEOUT_MS, DEFAULT_COMFYUI_WORKFLOW_LABEL, DEFAULT_GOOGLE_ENDPOINT, DEFAULT_GOOGLE_MODEL, DEFAULT_OPENAI_BASE_URL, DEFAULT_OPENAI_MODEL, DEFAULT_SEEDREAM_BASE_URL, DEFAULT_SEEDREAM_MODEL, IMAGE_PROVIDERS, type ImageProvider } from './shared.js';
-export { DEFAULT_DASHSCOPE_ENDPOINT, DEFAULT_DASHSCOPE_MODEL, DEFAULT_COMFYUI_BASE_URL, DEFAULT_COMFYUI_TIMEOUT_MS, DEFAULT_COMFYUI_WORKFLOW_LABEL, DEFAULT_GOOGLE_ENDPOINT, DEFAULT_GOOGLE_MODEL, DEFAULT_OPENAI_BASE_URL, DEFAULT_OPENAI_MODEL, DEFAULT_SEEDREAM_BASE_URL, DEFAULT_SEEDREAM_MODEL, IMAGE_PROVIDERS, type ImageProvider, };
+import { DEFAULT_DASHSCOPE_ENDPOINT, DEFAULT_DASHSCOPE_MODEL, DEFAULT_COMFYUI_BASE_URL, DEFAULT_COMFYUI_TIMEOUT_MS, DEFAULT_COMFYUI_WORKFLOW_LABEL, DEFAULT_GOOGLE_ENDPOINT, DEFAULT_GOOGLE_MODEL, DEFAULT_OPENAI_BASE_URL, DEFAULT_OPENAI_MODEL, DEFAULT_SEEDREAM_BASE_URL, DEFAULT_SEEDREAM_MODEL, IMAGE_PROVIDERS, activeComfyUIWorkflow, resolveComfyUIWorkflows, type ComfyUIWorkflowEntry, type ImageProvider } from './shared.js';
+export { DEFAULT_DASHSCOPE_ENDPOINT, DEFAULT_DASHSCOPE_MODEL, DEFAULT_COMFYUI_BASE_URL, DEFAULT_COMFYUI_TIMEOUT_MS, DEFAULT_COMFYUI_WORKFLOW_LABEL, DEFAULT_GOOGLE_ENDPOINT, DEFAULT_GOOGLE_MODEL, DEFAULT_OPENAI_BASE_URL, DEFAULT_OPENAI_MODEL, DEFAULT_SEEDREAM_BASE_URL, DEFAULT_SEEDREAM_MODEL, IMAGE_PROVIDERS, activeComfyUIWorkflow, resolveComfyUIWorkflows, type ComfyUIWorkflowEntry, type ImageProvider, };
 /** Default workspace subfolder that receives generated image files. */
 export declare const DEFAULT_WORKSPACE_FOLDER = "dsh-image-gen";
 /** Google API credential reference. */
@@ -29,9 +29,13 @@ export interface Config {
     dashscopeEndpoint?: string;
     dashscopeModel?: string;
     comfyuiBaseURL?: string;
-    /** ComfyUI API-format workflow JSON imported through the Web settings page. */
+    /** Named ComfyUI workflows managed by the Web settings page. */
+    comfyuiWorkflows?: ComfyUIWorkflowEntry[];
+    /** Name of the workflow ComfyUI calls use by default. */
+    comfyuiActiveWorkflow?: string;
+    /** Legacy single-workflow storage; synced to the active entry for downgrades. */
     comfyuiWorkflowJson?: string;
-    /** Original imported file name, used as a human-readable result label. */
+    /** Original imported file name of the legacy single workflow. */
     comfyuiWorkflowName?: string;
     comfyuiTimeoutMs?: number;
     /** Also write every generated image as a file under the session workspace. */
@@ -70,7 +74,12 @@ export declare function resolveProvider(config: Config): {
 } | {
     provider: 'comfyui';
     baseURL: string;
-    workflowJson: string;
-    workflowName: string;
+    workflows: ComfyUIWorkflowEntry[];
+    workflow?: ComfyUIWorkflowEntry;
     timeoutMs: number;
 };
+/** The workflow a ComfyUI call runs: the requested name when given, else the active one. */
+export declare function selectComfyUIWorkflow(active: {
+    workflows: ComfyUIWorkflowEntry[];
+    workflow?: ComfyUIWorkflowEntry;
+}, requested?: string): ComfyUIWorkflowEntry;

package/lib/types/image-route.d.ts

@@ -1,12 +1,19 @@
 /** Same-origin HTTP bridge from the Web result card to the Attachment service. */
 import type { IncomingMessage, ServerResponse } from 'node:http';
 import type { ImageAttachmentRef, StoredImageAttachment } from '@deepseek-ai/dsh-attachment';
-export { IMAGE_ROUTE } from './shared.js';
+export { IMAGE_ROUTE, DELETE_ROUTE } from './shared.js';
 /** Dependencies required by the image route. */
 export interface ImageRouteDeps {
     readImage(ref: ImageAttachmentRef): Promise<StoredImageAttachment>;
 }
+/** Dependencies required by the delete route. */
+export interface DeleteRouteDeps {
+    deleteWorkspaceImage(filePath: string): Promise<boolean>;
+    deleteWorkspaceImageByAttachmentId(attachmentId: string): Promise<boolean>;
+}
 /** Serve one verified durable image reference to a same-origin browser request. */
 export declare function serveImage(req: IncomingMessage, res: ServerResponse, deps: ImageRouteDeps): Promise<void>;
+/** Safely delete one or more generated image files from the workspace disk. */
+export declare function serveDelete(req: IncomingMessage, res: ServerResponse, deps: DeleteRouteDeps): Promise<void>;
 /** Validate the persisted reference carried by a tool presentation. */
 export declare function imageAttachmentFromMeta(meta: unknown): ImageAttachmentRef | undefined;

package/lib/types/index.d.ts

@@ -2,7 +2,7 @@
 import type { Context } from '@deepseek-ai/cordis';
 import { Config } from './config.js';
 export { Config } from './config.js';
-export { IMAGE_ROUTE, imageAttachmentFromMeta } from './image-route.js';
+export { IMAGE_ROUTE, DELETE_ROUTE, imageAttachmentFromMeta } from './image-route.js';
 export declare const name = "dsh-image-gen";
 export declare const inject: string[];
 export declare function apply(ctx: Context, config?: Config): void;

package/lib/types/shared.d.ts

@@ -1,6 +1,8 @@
 /** Values shared by the Host and browser Bundle faces. */
 /** Browser route used by the generated-image card. */
 export declare const IMAGE_ROUTE = "/plugins/dsh-image-gen/image";
+/** Browser route used for deleting generated images and workspace files. */
+export declare const DELETE_ROUTE = "/plugins/dsh-image-gen/delete";
 /** Namespace persisted through DSH Settings. */
 export declare const IMAGE_GENERATION_NAMESPACE = "image-generation";
 /** Supported providers. */
@@ -20,5 +22,36 @@ export declare const DEFAULT_GOOGLE_MODEL = "gemini-3.1-flash-image";
 export declare const DEFAULT_OPENAI_MODEL = "gpt-image-2";
 export declare const DEFAULT_SEEDREAM_MODEL = "doubao-seedream-5-0-260128";
 export declare const DEFAULT_DASHSCOPE_MODEL = "qwen-image-3.0";
+/** One named ComfyUI API-format workflow imported through settings. */
+export interface ComfyUIWorkflowEntry {
+    /** Unique human-readable label; used as the result model and by tool calls. */
+    name: string;
+    /** API-format workflow JSON with {{prompt}} / {{seed}} and optional {{image}} placeholders. */
+    json: string;
+    /** Optional preset prepended to the user prompt on every call of this workflow. */
+    presetPrompt?: string;
+}
+/** Raw ComfyUI workflow fields as persisted through DSH Settings. */
+export interface ComfyUIWorkflowSource {
+    /** Named workflows managed by the Web settings page. */
+    comfyuiWorkflows?: readonly ComfyUIWorkflowEntry[];
+    /** Name of the entry ComfyUI calls use by default. */
+    comfyuiActiveWorkflow?: string;
+    /** Legacy single-workflow storage; synced to the active entry for downgrades. */
+    comfyuiWorkflowJson?: string;
+    comfyuiWorkflowName?: string;
+}
+/** Named workflows, falling back to the legacy single-workflow fields when the list is empty. */
+export declare function resolveComfyUIWorkflows(source: ComfyUIWorkflowSource): ComfyUIWorkflowEntry[];
+/** The workflow ComfyUI calls use by default: the configured active name, else the first entry. */
+export declare function activeComfyUIWorkflow(source: ComfyUIWorkflowSource): ComfyUIWorkflowEntry | undefined;
+/** Derive a workflow label that does not collide with the given existing names. */
+export declare function uniqueComfyUIWorkflowName(name: string, existing: readonly string[]): string;
+/**
+ * Combine a workflow's preset with the user prompt: preset first, user second,
+ * joined by one comma — never doubled when the preset already ends in a
+ * separator, and reduced to the non-empty side when the other is blank.
+ */
+export declare function mergeComfyUIPrompt(preset: string | undefined, user: string): string;
 export declare const DEFAULT_MODELS: Record<ImageProvider, string>;
 export declare const DEFAULT_BASE_URLS: Record<ImageProvider, string>;

package/lib/types/workspace-save.d.ts

@@ -50,3 +50,24 @@ export declare function saveImageToWorkspace(options: {
     data: Uint8Array;
     signal?: AbortSignal;
 }): Promise<string>;
+/** Discover all DSH workspace paths recorded in local application storage. */
+export declare function getDshWorkspaceRoots(): Promise<string[]>;
+/**
+ * Safely delete a generated image file from workspace disk by its path.
+ * Enforces strict safety gates:
+ * 1. Base name must match generated image pattern (`image-<hex>.<ext>`) to avoid touching user files.
+ * 2. Path must be a regular file and NOT a symbolic link.
+ * 3. Real canonical path's basename must also match the pattern.
+ * 4. Real canonical path must reside within an allowed workspace root (or process.cwd()).
+ */
+export declare function deleteImageFromWorkspace(filePath: string, allowedWorkspaceRoots?: Iterable<string>): Promise<boolean>;
+/**
+ * Safely find and delete a generated image file by its attachment ID within a single workspace root.
+ * Strictly checks sha256:64hex format and avoids scanning unrelated workspaces.
+ * Only used as fallback for historical images where savedTo was not persisted.
+ */
+export declare function deleteImageByAttachmentIdFromWorkspace(attachmentId: string, options?: {
+    workspaceRoot?: string | undefined;
+    folder?: string | undefined;
+    allowedWorkspaceRoots?: Iterable<string> | undefined;
+}): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-image-gen",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope, local ComfyUI & more.",
   "type": "module",
   "author": "shanliuling",
@@ -119,7 +119,7 @@
     "@deepseek-ai/dsh-credentials": "0.1.1-rc.2",
     "@deepseek-ai/dsh-host-webserver": "0.1.1-rc.2",
     "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.2-alpha.2",
     "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
     "@deepseek-ai/schemastery": "3.18.1",
     "@types/node": "^22.20.0",
@@ -127,7 +127,11 @@
     "react": "^18.2.0",
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
+    "unrun": "^0.3.1",
     "vitest": "^4.1.8"
   },
-  "packageManager": "pnpm@11.7.0"
+  "packageManager": "pnpm@11.7.0",
+  "dependencies": {
+    "lucide-react": "^1.38.0"
+  }
 }