dsh-image-gen 0.2.5 → 0.3.0

package/lib/types/client/browser-image-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Shared browser image and DOM helpers for client views.
+ * Completely decoupled from gallery-view and studio-view to prevent circular dependencies.
+ */
+/** Copy an image Blob to the OS clipboard, converting to PNG if required by the browser. */
+export declare function copyImageBlob(blob: Blob): Promise<boolean>;
+/** Safely trigger a browser file download by mounting an anchor element into the DOM. */
+export declare function downloadBlobUrl(url: string, filename: string): void;
+/** Human-readable relative time formatter supporting zh and en. */
+export declare function formatRelativeTime(timestamp: number, lang: 'zh' | 'en'): string;

package/lib/types/client/conversation-image-revisions.d.ts

@@ -0,0 +1,25 @@
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+import type { CloudImageProvider } from '../shared.js';
+/** One regenerated version displayed in place of an original conversation image. */
+export interface ConversationImageRevision {
+    attachment: ImageAttachmentRef;
+    prompt: string;
+    provider: CloudImageProvider;
+    model: string;
+    output: string;
+    createdAt: number;
+    ratio: string;
+    quality: string;
+}
+export interface ConversationImageRevisionChain {
+    originId: string;
+    /** Zero selects the immutable conversation image; revisions use one-based positions. */
+    currentIndex: number;
+    revisions: ConversationImageRevision[];
+}
+/** Read the locally persisted replacement history for one immutable conversation image. */
+export declare function loadConversationImageRevisionChain(originId: string): ConversationImageRevisionChain;
+/** Append a generated version and make it the version shown by the conversation card. */
+export declare function appendConversationImageRevision(originId: string, revision: ConversationImageRevision): ConversationImageRevisionChain;
+/** Select an earlier or later version without altering the underlying conversation event. */
+export declare function selectConversationImageRevision(originId: string, requestedIndex: number): ConversationImageRevisionChain;

package/lib/types/client/conversation-regenerate.d.ts

@@ -0,0 +1,11 @@
+import { type StudioGenerateRequest } from '../shared.js';
+export interface RegeneratableImage {
+    provider: string;
+    model: string;
+    output?: string | undefined;
+}
+/** Build the workbench request that reproduces a conversation image with an edited prompt. */
+export declare function conversationRegenerateRequest(image: RegeneratableImage, prompt: string, remembered?: {
+    ratio: string;
+    quality: string;
+} | undefined): StudioGenerateRequest;

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

@@ -12,11 +12,23 @@ 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;
+    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;
+    /** Workspace filesystem path where the image was generated/saved */
+    workspacePath?: string | undefined;
+    /** Workspace ID if known */
+    workspaceId?: string | undefined;
+    /** Conversation session ID where the image was generated */
+    sessionId?: string | undefined;
 }
 type GalleryListener = () => void;
 /**
@@ -26,6 +38,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;
@@ -34,12 +47,34 @@ 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.
  */
 export declare function clearGallery(): Promise<void>;
+/**
+ * Standardize path format across Windows and POSIX (lowercase, forward slashes, no trailing slash).
+ */
+export declare function normalizeWorkspacePath(rawPath: string): string;
+/**
+ * Determine if a gallery item belongs to the given workspace context.
+ * Compares workspaceId, sessionId membership, workspacePath, and savedTo file path prefix.
+ */
+export declare function isItemInWorkspace(item: GalleryItem, workspace?: {
+    workspaceId?: string | undefined;
+    path?: string | undefined;
+    sessionIds?: readonly string[] | undefined;
+} | null): boolean;
 export {};

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,65 +10,179 @@ export interface LocaleService {
     };
     subscribe(fn: () => void): () => void;
 }
+export type TabKey = 'gallery' | 'studio' | 'favorites';
+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 filterCurrentWorkspace: "仅看此工作区";
+        readonly filterCurrentWorkspaceHint: "只展示属于当前工作区的生图记录与物理文件";
+        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: "复制图片";
         readonly copyPpt: "复制 Prompt";
+        readonly regenerate: "重新生成";
+        readonly regenerateTitle: "重新生成图片";
+        readonly regenerateHint: "可按需修改 Prompt，基于当前模型和比例在画廊生成一张新图片。";
+        readonly confirmRegenerate: "开始生成";
+        readonly regenerating: "正在重新生成…";
+        readonly regenerateSuccess: "已生成新图片并收录到画廊";
+        readonly regenerateFailed: "重新生成失败";
         readonly delete: "从画廊删除";
         readonly confirmDelete: "确定要从画廊中删除这张图片吗？（不会影响原聊天记录）";
         readonly deleted: "已从画廊删除";
         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 filterCurrentWorkspace: "Current workspace only";
+        readonly filterCurrentWorkspaceHint: "Only show images belonging to the active workspace";
+        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";
         readonly copyPpt: "Copy Prompt";
+        readonly regenerate: "Regenerate";
+        readonly regenerateTitle: "Regenerate Image";
+        readonly regenerateHint: "Edit prompt if needed. A new image will be generated and added to the gallery.";
+        readonly confirmRegenerate: "Generate";
+        readonly regenerating: "Regenerating…";
+        readonly regenerateSuccess: "New image generated and added to gallery";
+        readonly regenerateFailed: "Regeneration failed";
         readonly delete: "Delete from gallery";
         readonly confirmDelete: "Are you sure you want to remove this image from the gallery? (Chat history will not be affected)";
         readonly deleted: "Deleted from gallery";
         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;
-export declare const GalleryViewTab: FC<{
+export interface GalleryViewTabProps {
     locale?: LocaleService;
-}>;
-export declare function copyImageBlob(blob: Blob): Promise<boolean>;
-export {};
+    sessionId?: string;
+    useSession?: (selector: (state: any) => any) => any;
+    useSessions?: (selector: (state: any) => any) => any;
+    useWorkspaces?: (selector: (state: any) => any) => any;
+}
+export declare const GalleryViewTab: FC<GalleryViewTabProps>;
+export { copyImageBlob } from './browser-image-utils.js';

package/lib/types/client/image-cache.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Bounded in-memory attachment image cache for client views.
+ *
+ * Enforces dual constraints (max items + max bytes) with LRU eviction.
+ * The background fetch lifecycle is decoupled from individual consumer signals,
+ * preventing a canceled thumbnail from aborting the shared blob request.
+ */
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+export declare const MAX_CACHE_COUNT = 30;
+export declare const MAX_CACHE_BYTES: number;
+/**
+ * Fetch or reuse an image Blob by attachment ID.
+ * Refreshes LRU recency on hit and enforces count/byte limits on arrival.
+ */
+export declare function fetchAttachmentBlob(attachment: ImageAttachmentRef): Promise<Blob>;
+/** Check if an attachment Blob is already cached in memory. */
+export declare function getCachedAttachmentBlob(attachmentId: string | ImageAttachmentRef['attachmentId']): Promise<Blob> | undefined;
+/** Evict one item from memory cache (e.g. when deleted from gallery). */
+export declare function evictAttachmentCache(attachmentId: string | ImageAttachmentRef['attachmentId']): void;
+/** Clear all in-memory image caches. */
+export declare function clearAttachmentCache(): void;
+/** Get current cache size metrics (useful for assertions and health monitoring). */
+export declare function getCacheMetrics(): {
+    count: number;
+    bytes: number;
+};

package/lib/types/client/studio-style.d.ts

@@ -0,0 +1 @@
+export declare const STUDIO_STYLE = "\n.dsh-ig-gallery-page-body.is-workbench{flex:1 1 0;height:100%;min-height:0;padding:0;overflow:hidden;display:flex;flex-direction:column}\n.dsh-ig-workbench{--ig-blue:#2f64f5;--ig-line:color-mix(in srgb,currentColor 11%,transparent);--ig-soft:color-mix(in srgb,currentColor 4%,transparent);position:relative;display:flex;flex-direction:column;min-height:0;height:100%;overflow:hidden;padding:10px 12px 12px;color:var(--foreground,#182033);box-sizing:border-box;background:radial-gradient(circle at 60% -20%,rgba(63,104,246,.07),transparent 30%)}\n.dsh-ig-workbench *{box-sizing:border-box}.dsh-ig-workbench button,.dsh-ig-workbench select,.dsh-ig-workbench textarea{font:inherit;color:inherit}\n.dsh-ig-workbench-grid{display:grid;grid-template-columns:minmax(190px,238px) minmax(0,1fr) minmax(286px,340px);grid-template-rows:minmax(0,1fr);min-height:0;height:0;flex:1 1 0;border:1px solid var(--ig-line);border-radius:12px;overflow:hidden;background:var(--background,#fff);box-shadow:0 12px 32px rgba(30,42,76,.05);transition:grid-template-columns .2s ease}\n.dsh-ig-workbench-grid.is-sidebar-collapsed{grid-template-columns:minmax(0,1fr) minmax(286px,340px)}\n.dsh-ig-recent-panel,.dsh-ig-generate-panel{min-width:0;min-height:0;overflow:hidden;background:color-mix(in srgb,var(--background,#fff) 96%,#f5f7fb)}.dsh-ig-recent-panel{display:flex;flex-direction:column;border-right:1px solid var(--ig-line)}\n.dsh-ig-panel-title{height:48px;flex:0 0 48px;padding:0 12px 0 14px;display:flex;align-items:center;justify-content:space-between;border-bottom:1px solid var(--ig-line);font-size:13px;font-weight:650}\n.dsh-ig-count-badge{font-size:11px;min-width:22px;text-align:center;padding:2px 6px;border-radius:999px;background:var(--ig-soft);color:#7b8498;font-weight:500}\n.dsh-ig-collapse-btn{width:28px;height:28px;display:inline-flex;align-items:center;justify-content:center;border:1px solid transparent;border-radius:6px;background:transparent;color:#717b90;cursor:pointer;transition:all .15s}\n.dsh-ig-collapse-btn:hover{border-color:var(--ig-line);background:var(--ig-soft);color:var(--foreground,#182033)}\n.dsh-ig-recent-scroll{flex:1 1 0;height:0;padding:8px;overflow-x:hidden;overflow-y:auto;min-height:0}.dsh-ig-recent-empty{min-height:180px;display:flex;flex-direction:column;justify-content:center;align-items:center;gap:10px;color:#929bad;text-align:center;font-size:12px}\n.dsh-ig-recent-item{display:grid;grid-template-columns:70px minmax(0,1fr);gap:10px;width:100%;padding:8px;border:1px solid transparent;border-radius:9px;background:transparent;text-align:left;cursor:pointer;transition:background .16s,border-color .16s,transform .16s}.dsh-ig-recent-item:hover{background:var(--ig-soft);transform:translateY(-1px)}.dsh-ig-recent-item.is-active{border-color:#89a7ff;background:rgba(47,100,245,.075);box-shadow:inset 3px 0 0 var(--ig-blue)}.dsh-ig-recent-thumb{width:70px;height:70px;border-radius:7px;display:flex;align-items:center;justify-content:center;overflow:hidden;background:#eef1f7;color:#929bad}.dsh-ig-recent-thumb img{width:100%;height:100%;object-fit:cover}.dsh-ig-recent-item>div:last-child{min-width:0;padding:1px 0}.dsh-ig-recent-item strong{display:block;white-space:nowrap;text-overflow:ellipsis;overflow:hidden;font-size:12.5px;line-height:19px;font-weight:630}.dsh-ig-recent-item span,.dsh-ig-recent-item small{display:block;white-space:nowrap;text-overflow:ellipsis;overflow:hidden;color:#828b9e;font-size:10.5px;line-height:16px}\n.dsh-ig-load-more{width:100%;height:32px;margin:8px 0;display:flex;align-items:center;justify-content:center;border:1px dashed var(--ig-line);border-radius:7px;background:transparent;font-size:11px;color:#6b758b;cursor:pointer;transition:background .15s,color .15s}.dsh-ig-load-more:hover{background:var(--ig-soft);color:var(--ig-blue);border-color:#a2b9f6}\n.dsh-ig-mini-btn{height:22px;padding:0 7px;display:inline-flex;align-items:center;gap:3px;border:1px solid var(--ig-line);border-radius:5px;background:var(--background,#fff);font-size:10.5px;font-weight:500;color:var(--foreground,#242f44);cursor:pointer;transition:all .15s}.dsh-ig-mini-btn:hover{border-color:#9bb4f5;color:var(--ig-blue);background:rgba(47,100,245,.06)}\n.dsh-ig-canvas-column{min-width:0;min-height:0;height:100%;overflow:hidden;display:flex;flex-direction:column;background:color-mix(in srgb,var(--background,#fff) 97%,#e8edf7)}\n.dsh-ig-canvas-toolbar{height:46px;flex:0 0 46px;display:flex;align-items:center;justify-content:space-between;gap:8px;padding:0 14px;border-bottom:1px solid var(--ig-line)}\n.dsh-ig-canvas-toolbar-left,.dsh-ig-canvas-toolbar-right{display:flex;align-items:center;gap:6px}\n.dsh-ig-canvas-toolbar button{height:30px;min-width:30px;padding:0 9px;display:inline-flex;align-items:center;justify-content:center;gap:5px;border:1px solid var(--ig-line);border-radius:7px;background:var(--background,#fff);color:var(--foreground,#242f44);font-size:11.5px;font-weight:500;cursor:pointer;transition:border-color .15s,background .15s,color .15s}\n.dsh-ig-canvas-toolbar button:hover{border-color:#9bb4f5;background:rgba(47,100,245,.05);color:var(--ig-blue)}\n.dsh-ig-canvas-toolbar button.is-active{border-color:#8ba8f8;background:rgba(47,100,245,.08);color:var(--ig-blue);font-weight:550}\n.dsh-ig-zoom-display{font-size:11px;min-width:38px;text-align:center;color:#64748b;user-select:none;font-variant-numeric:tabular-nums}\n.dsh-ig-status-badge-wrap{position:relative;display:inline-flex;align-items:center}\n.dsh-ig-status-badge{height:30px;display:inline-flex;align-items:center;gap:7px;padding:0 10px;border:1px solid var(--ig-line);border-radius:7px;background:var(--background,#fff);cursor:pointer;user-select:none;transition:border-color .15s,background .15s,box-shadow .15s}\n.dsh-ig-status-badge:hover{border-color:#9bb4f5;background:rgba(47,100,245,.04)}\n.dsh-ig-status-dot{width:7px;height:7px;min-width:7px;max-width:7px;border-radius:50%;flex-shrink:0;box-sizing:border-box}\n.dsh-ig-status-dot.is-ready{background:#10b981;box-shadow:0 0 0 2px rgba(16,185,129,.2)}\n.dsh-ig-status-dot.is-muted{background:#ef4444;box-shadow:0 0 0 2px rgba(239,68,68,.2)}\n.dsh-ig-status-text{font-size:11.5px;font-weight:500;color:var(--foreground,#242f44);line-height:1}\n.dsh-ig-status-arrow{color:#94a3b8;transition:transform .15s,color .15s}\n.dsh-ig-status-badge-wrap:hover .dsh-ig-status-arrow{transform:rotate(180deg);color:var(--ig-blue)}\n.dsh-ig-status-popover{position:absolute;left:0;top:calc(100% + 6px);width:260px;background:var(--background,#fff);border:1px solid var(--ig-line);border-radius:9px;box-shadow:0 12px 36px rgba(20,28,45,.14);padding:10px 12px;z-index:40;opacity:0;pointer-events:none;transform:translateY(4px);transition:opacity .15s cubic-bezier(.16,1,.3,1),transform .15s cubic-bezier(.16,1,.3,1)}\n.dsh-ig-status-badge-wrap:hover .dsh-ig-status-popover{opacity:1;pointer-events:auto;transform:translateY(0)}\n.dsh-ig-status-popover-title{display:flex;align-items:center;justify-content:space-between;font-size:10px;font-weight:650;color:#8590a6;margin-bottom:8px;letter-spacing:.02em;text-transform:uppercase}\n.dsh-ig-status-list{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:5px}\n.dsh-ig-status-list li{display:flex;align-items:center;justify-content:space-between;gap:8px;padding:6px 8px;border-radius:6px;transition:background .12s}\n.dsh-ig-status-list li.is-configured{background:rgba(16,185,129,.05);border:1px solid rgba(16,185,129,.12)}\n.dsh-ig-status-list li.is-missing{background:rgba(239,68,68,.04);border:1px solid rgba(239,68,68,.12);opacity:.75}\n.dsh-ig-status-item-name{display:flex;flex-direction:column;min-width:0}\n.dsh-ig-status-item-name strong{font-size:11.5px;font-weight:600;color:var(--foreground,#182033);line-height:16px}\n.dsh-ig-status-item-name small{font-size:9.5px;color:#7c869a;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:145px;line-height:14px}\n.dsh-ig-status-item-tag{font-size:10px;font-weight:600;padding:2px 6px;border-radius:4px;flex-shrink:0}\n.is-configured .dsh-ig-status-item-tag{color:#059669;background:rgba(16,185,129,.14)}\n.is-missing .dsh-ig-status-item-tag{color:#dc2626;background:rgba(239,68,68,.14)}\n.dsh-ig-canvas{position:relative;flex:1 1 0;height:0;min-height:0;display:flex;align-items:center;justify-content:center;overflow:hidden;padding:24px;touch-action:none;user-select:none;cursor:grab;background-image:linear-gradient(45deg,rgba(114,128,156,.035) 25%,transparent 25%),linear-gradient(-45deg,rgba(114,128,156,.035) 25%,transparent 25%),linear-gradient(45deg,transparent 75%,rgba(114,128,156,.035) 75%),linear-gradient(-45deg,transparent 75%,rgba(114,128,156,.035) 75%);background-size:24px 24px;background-position:0 0,0 12px,12px -12px,-12px 0}\n.dsh-ig-canvas.is-dragging{cursor:grabbing!important}\n.dsh-ig-canvas img{display:block;max-width:100%;max-height:100%;width:auto;height:auto;border-radius:10px;box-shadow:0 14px 45px rgba(25,35,63,.18);user-select:none;-webkit-user-drag:none;pointer-events:auto}\n.dsh-ig-canvas-empty,.dsh-ig-generating-state{display:flex;flex-direction:column;align-items:center;justify-content:center;text-align:center;gap:12px;color:#929bad;font-size:12px;padding:26px;cursor:default}\n.dsh-ig-generating-state strong{font-size:15px;color:var(--foreground,#182033)}.dsh-ig-generating-state span{font-size:11px}.dsh-ig-generation-orbit{width:66px;height:66px;border-radius:50%;display:grid;place-items:center;color:var(--ig-blue);background:rgba(47,100,245,.09);box-shadow:0 0 0 10px rgba(47,100,245,.035);animation:dshIgPulse 1.8s ease-in-out infinite}\n.dsh-ig-result-strip{flex:0 0 auto;min-height:52px;padding:8px 14px;display:flex;align-items:center;justify-content:space-between;gap:12px;border-top:1px solid var(--ig-line)}.dsh-ig-result-strip>span{font-size:12px;font-weight:650}.dsh-ig-result-strip>div,.dsh-ig-result-actions>div{display:flex;gap:7px}.dsh-ig-result-strip button,.dsh-ig-result-actions button{height:32px;display:inline-flex;align-items:center;gap:6px;padding:0 10px;border:1px solid var(--ig-line);border-radius:7px;background:var(--background,#fff);font-size:11px;cursor:pointer}.dsh-ig-result-strip button:hover,.dsh-ig-result-actions button:hover{border-color:#9fb2ed;color:var(--ig-blue)}.dsh-ig-result-actions{flex:0 0 auto;min-height:54px;padding:8px 14px;display:flex;align-items:center;justify-content:space-between;gap:12px;border-top:1px solid var(--ig-line)}.dsh-ig-result-actions p{margin:0;min-width:0;display:-webkit-box;-webkit-line-clamp:2;-webkit-box-orient:vertical;overflow:hidden;font-size:11.5px;line-height:18px;color:#596277}.dsh-ig-result-meta{flex:0 0 auto;min-height:32px;padding:6px 14px;display:flex;gap:13px;align-items:center;flex-wrap:wrap;border-top:1px solid var(--ig-line);font-size:10px;color:#8790a3}.dsh-ig-result-meta span+span:before{content:'\u00B7';margin-right:13px}\n.dsh-ig-generate-panel{height:100%;display:flex;flex-direction:column;border-left:1px solid var(--ig-line);overflow:hidden}.dsh-ig-panel-tabs{height:48px;flex:0 0 48px;display:grid;grid-template-columns:1fr 1fr;border-bottom:1px solid var(--ig-line);padding:0 14px}.dsh-ig-panel-tabs button{position:relative;border:0;background:transparent;font-size:12px;color:#7c8598;cursor:pointer}.dsh-ig-panel-tabs button.is-active{color:var(--ig-blue);font-weight:650}.dsh-ig-panel-tabs button.is-active:after{content:'';position:absolute;left:20%;right:20%;bottom:-1px;height:2px;background:var(--ig-blue);border-radius:2px 2px 0 0}.dsh-ig-generator-form{flex:1 1 0;height:0;padding:15px;display:flex;flex-direction:column;gap:15px;overflow-x:hidden;overflow-y:auto;min-height:0}.dsh-ig-mode-switch{display:grid;grid-template-columns:1fr 1fr;gap:8px}.dsh-ig-mode-switch button{height:39px;border:1px solid var(--ig-line);border-radius:8px;background:var(--background,#fff);display:flex;align-items:center;justify-content:center;gap:7px;font-size:12px;cursor:pointer}.dsh-ig-mode-switch button.is-active{border-color:#789bff;color:var(--ig-blue);background:rgba(47,100,245,.065);box-shadow:inset 0 0 0 1px rgba(47,100,245,.1)}\n.dsh-ig-field{position:relative;display:flex;flex-direction:column;gap:7px}.dsh-ig-field>label,.dsh-ig-field-label label{font-size:11.5px;font-weight:630}.dsh-ig-field>label span{font-weight:400;color:#929bad}.dsh-ig-field-label{display:flex;align-items:center;justify-content:space-between}.dsh-ig-field-label b{color:#e14d4d}.dsh-ig-field-label button{border:0;background:transparent;color:#798397;font-size:10.5px;cursor:pointer}.dsh-ig-field textarea{width:100%;height:112px;padding:11px 12px 22px;resize:vertical;border:1px solid var(--ig-line);border-radius:9px;background:var(--background,#fff);font-size:12px;line-height:19px;outline:none}.dsh-ig-field textarea:focus{border-color:var(--ig-blue);box-shadow:0 0 0 3px rgba(47,100,245,.09)}.dsh-ig-field>small{position:absolute;right:9px;bottom:7px;color:#9aa2b2;font-size:9.5px}.dsh-ig-field-grid{display:grid;grid-template-columns:1fr 1fr;gap:9px}.dsh-ig-field-select{display:flex;flex-direction:column;gap:6px;min-width:0}.dsh-ig-field-select>span{font-size:11px;font-weight:620}.dsh-ig-field-select select{width:100%;height:36px;padding:0 26px 0 9px;border:1px solid var(--ig-line);border-radius:8px;background:var(--background,#fff);font-size:11px;outline:none;text-overflow:ellipsis}.dsh-ig-field-select select:focus{border-color:var(--ig-blue)}\n.dsh-ig-upload{height:92px;border:1px dashed #bcc6d9;border-radius:9px;background:rgba(255,255,255,.45);display:flex;flex-direction:column;align-items:center;justify-content:center;gap:5px;color:#7d879b;cursor:pointer}.dsh-ig-upload strong{font-size:11px;font-weight:570}.dsh-ig-upload small{font-size:9.5px}.dsh-ig-upload:hover,.dsh-ig-upload.is-dragging{border-color:var(--ig-blue);background:rgba(47,100,245,.05);color:var(--ig-blue)}\n.dsh-ig-reference-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(64px,1fr));gap:8px}\n.dsh-ig-reference-card{position:relative;aspect-ratio:1;border-radius:8px;overflow:hidden;background:#eef1f7;border:1px solid var(--ig-line)}\n.dsh-ig-reference-card img{width:100%;height:100%;object-fit:cover}\n.dsh-ig-reference-card button{position:absolute;right:4px;top:4px;width:18px;height:18px;border:0;border-radius:50%;display:grid;place-items:center;background:rgba(20,28,45,.75);color:#fff;cursor:pointer;padding:0;transition:background .15s}\n.dsh-ig-reference-card button:hover{background:#ef4444}\n.dsh-ig-reference-add{aspect-ratio:1;border:1px dashed #bcc6d9;border-radius:8px;background:rgba(255,255,255,.45);display:flex;flex-direction:column;align-items:center;justify-content:center;gap:3px;color:#7d879b;cursor:pointer;font-size:10px;transition:border-color .15s,color .15s,background .15s}\n.dsh-ig-reference-add:hover{border-color:var(--ig-blue);background:rgba(47,100,245,.05);color:var(--ig-blue)}\n.dsh-ig-reference-preview{position:relative;height:108px;border-radius:9px;overflow:hidden;background:#eef1f7}.dsh-ig-reference-preview img{width:100%;height:100%;object-fit:contain}.dsh-ig-reference-preview button{position:absolute;right:7px;top:7px;width:25px;height:25px;border:0;border-radius:50%;display:grid;place-items:center;background:rgba(20,28,45,.72);color:#fff;cursor:pointer}\n.dsh-ig-inline-note,.dsh-ig-form-error{padding:9px 10px;border-radius:7px;font-size:10.5px;line-height:16px}.dsh-ig-inline-note{background:#fff8e7;color:#8b671c;border:1px solid #f1dfae}.dsh-ig-form-error{background:#fff1f1;color:#b63737;border:1px solid #f2caca}.dsh-ig-form-loading{height:70px;display:grid;place-items:center;color:var(--ig-blue)}\n.dsh-ig-config-error{padding:14px;display:flex;flex-direction:column;align-items:center;gap:10px;background:#fff1f1;border:1px solid #f2caca;border-radius:8px;color:#b63737;font-size:11.5px;text-align:center}.dsh-ig-config-error p{margin:0;line-height:17px}.dsh-ig-config-error button{height:30px;display:inline-flex;align-items:center;gap:6px;padding:0 12px;border:1px solid #e0a8a8;border-radius:6px;background:#fff;color:#b63737;font-size:11.5px;font-weight:600;cursor:pointer}.dsh-ig-config-error button:hover{background:#ffebeb}\n.dsh-ig-generate-button{height:42px;flex:0 0 auto;border:0;border-radius:8px;background:linear-gradient(135deg,#386cf6,#2758e7);color:#fff!important;display:flex;align-items:center;justify-content:center;gap:8px;font-size:12px;font-weight:650;cursor:pointer;box-shadow:0 8px 18px rgba(47,100,245,.22);transition:transform .16s,box-shadow .16s}.dsh-ig-generate-button:hover:not(:disabled){transform:translateY(-1px);box-shadow:0 10px 24px rgba(47,100,245,.28)}.dsh-ig-generate-button:disabled{opacity:.55;cursor:not-allowed;box-shadow:none}\n.dsh-ig-generate-button.is-cancel{background:linear-gradient(135deg,#ef4444,#dc2626);box-shadow:0 8px 18px rgba(239,68,68,.25)}.dsh-ig-generate-button.is-cancel:hover{background:linear-gradient(135deg,#dc2626,#b91c1c);box-shadow:0 10px 24px rgba(239,68,68,.35)}\n.dsh-ig-details{padding:16px;margin:0;overflow:auto}.dsh-ig-details>div{padding:12px 0;border-bottom:1px solid var(--ig-line)}.dsh-ig-details dt{font-size:10.5px;color:#8992a4;margin-bottom:5px}.dsh-ig-details dd{margin:0;font-size:11.5px;line-height:18px;word-break:break-word}.dsh-ig-details-empty{display:flex;flex-direction:column;align-items:center;justify-content:center;gap:12px;height:220px;padding:20px;color:#929bad;font-size:11px;text-align:center}\n.dsh-ig-workbench-modal-backdrop{position:fixed;inset:0;background:rgba(15,23,42,.45);backdrop-filter:blur(3px);z-index:999;display:grid;place-items:center;padding:16px}\n.dsh-ig-workbench-modal-box{width:100%;max-width:380px;background:var(--background,#fff);border-radius:12px;padding:20px;box-shadow:0 20px 48px rgba(0,0,0,.22);display:flex;flex-direction:column;gap:14px}\n.dsh-ig-workbench-modal-header{display:flex;align-items:center;gap:10px}\n.dsh-ig-workbench-modal-header strong{font-size:14px;font-weight:650;color:#b91c1c}\n.dsh-ig-workbench-modal-desc{font-size:12px;line-height:18px;color:#555f77;margin:0}\n.dsh-ig-workbench-modal-option{display:flex;align-items:center;gap:8px;font-size:11.5px;color:#4b5563;cursor:pointer}\n.dsh-ig-workbench-modal-actions{display:flex;justify-content:flex-end;gap:8px;margin-top:4px}\n.dsh-ig-workbench-modal-actions button{height:32px;padding:0 14px;border-radius:7px;font-size:11.5px;font-weight:600;cursor:pointer}\n.dsh-ig-workbench-modal-cancel{border:1px solid var(--ig-line);background:var(--background,#fff);color:#6b7280}\n.dsh-ig-workbench-modal-cancel:hover{background:#f3f4f6}\n.dsh-ig-workbench-modal-danger{border:0;background:#dc2626;color:#fff}\n.dsh-ig-workbench-modal-danger:hover{background:#b91c1c}\n@keyframes dshIgPulse{50%{transform:scale(1.06);box-shadow:0 0 0 16px rgba(47,100,245,.025)}}\n.dsh-ig-workbench-toast{position:fixed;bottom:28px;left:50%;transform:translateX(-50%);background:rgba(15,23,42,0.88);backdrop-filter:blur(8px);-webkit-backdrop-filter:blur(8px);color:#fff;padding:8px 18px;border-radius:10px;font-size:12.5px;font-weight:500;box-shadow:0 12px 32px rgba(0,0,0,0.3);z-index:99999;animation:dshIgFade .15s ease-out;pointer-events:none}\n@keyframes dshIgFade{from{opacity:0;transform:translate(-50%,6px)}to{opacity:1;transform:translate(-50%,0)}}\n@media(max-width:1120px){.dsh-ig-workbench-grid{grid-template-columns:190px minmax(360px,1fr) 300px}.dsh-ig-result-actions button span{display:none}}\n@media(max-width:900px){.dsh-ig-gallery-page-body.is-workbench{height:auto;overflow:auto}.dsh-ig-workbench{height:auto;min-height:100%;overflow:visible;padding:12px}.dsh-ig-workbench-heading{height:auto;padding-bottom:12px;align-items:center}.dsh-ig-provider-quick>span{display:none}.dsh-ig-workbench-grid{height:auto;display:flex;flex:none;flex-direction:column;overflow:visible}.dsh-ig-recent-panel{height:auto;overflow:hidden;border-right:0;border-bottom:1px solid var(--ig-line)}.dsh-ig-recent-scroll{height:auto;display:flex;overflow-x:auto;overflow-y:hidden;padding:8px}.dsh-ig-recent-item{min-width:220px}.dsh-ig-canvas-column{height:auto;min-height:560px}.dsh-ig-generate-panel{height:auto;border-left:0;border-top:1px solid var(--ig-line);min-height:560px}.dsh-ig-generator-form{height:auto;overflow:visible}.dsh-ig-canvas{height:auto;min-height:360px}}\n@media(max-width:560px){.dsh-ig-workbench-heading>div{display:block}.dsh-ig-workbench-heading h1{font-size:15px}.dsh-ig-provider-quick select{min-width:128px;max-width:150px}.dsh-ig-canvas{padding:12px;min-height:300px}.dsh-ig-result-strip,.dsh-ig-result-actions{align-items:flex-start;flex-direction:column}.dsh-ig-result-strip>div,.dsh-ig-result-actions>div{width:100%}.dsh-ig-result-strip button,.dsh-ig-result-actions button{flex:1;justify-content:center}.dsh-ig-result-actions button span{display:inline}.dsh-ig-field-grid{grid-template-columns:1fr}.dsh-ig-result-meta span+span:before{display:none}}\n@media(prefers-reduced-motion:reduce){.dsh-ig-workbench *{scroll-behavior:auto!important;animation-duration:.01ms!important;transition-duration:.01ms!important}}\n.dsh-ig-workspace-filter-label{height:30px;display:inline-flex;align-items:center;gap:6px;padding:0 10px;border:1px solid var(--ig-line,rgba(0,0,0,.1));border-radius:7px;background:var(--background,#fff);font-size:11.5px;color:var(--foreground,#242f44);cursor:pointer;user-select:none;transition:border-color .15s,background .15s}\n.dsh-ig-workspace-filter-label:hover{border-color:#9bb4f5;background:rgba(47,100,245,.04)}\n.dsh-ig-workspace-checkbox{cursor:pointer;accent-color:#2f64f5;width:13.5px;height:13.5px;margin:0}\n.dsh-ig-workspace-filter-text{font-weight:500;white-space:nowrap}\n.dsh-ig-workspace-filter-badge{font-size:10px;font-weight:600;padding:1px 6px;border-radius:999px;background:color-mix(in srgb,currentColor 7%,transparent);color:#64748b;font-variant-numeric:tabular-nums}\n";

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

@@ -0,0 +1,30 @@
+import { type FC } from 'react';
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+export interface LocaleService {
+    subscribe(cb: () => void): () => void;
+    getSnapshot(): {
+        active?: string;
+    };
+}
+export interface StudioReferenceItem {
+    id: string;
+    attachment?: ImageAttachmentRef;
+    file?: File;
+    previewUrl: string;
+}
+export interface StudioWorkspaceProps {
+    workspaceId?: string | undefined;
+    path?: string | undefined;
+    title?: string | undefined;
+    sessionIds?: readonly string[] | undefined;
+}
+export declare const StudioView: FC<{
+    locale?: LocaleService | undefined;
+    workspace?: StudioWorkspaceProps | null | undefined;
+}>;
+export declare function useAttachmentImage(attachment: ImageAttachmentRef | undefined, shouldLoad?: boolean): {
+    url: string | null;
+    blob: Blob | null;
+    loading: boolean;
+};
+export declare function fileToBase64(file: File): Promise<string>;

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

@@ -1,12 +1,18 @@
 /** 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>;
+}
 /** 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,8 @@
 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 { STUDIO_ROUTE } from './shared.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,11 +1,84 @@
 /** Values shared by the Host and browser Bundle faces. */
+import type { ImageAttachmentRef, ImageMediaType } from '@deepseek-ai/dsh-attachment';
 /** 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";
+/** Same-origin route used by the browser image workbench. */
+export declare const STUDIO_ROUTE = "/plugins/dsh-image-gen/studio";
 /** Namespace persisted through DSH Settings. */
 export declare const IMAGE_GENERATION_NAMESPACE = "image-generation";
 /** Supported providers. */
 export declare const IMAGE_PROVIDERS: readonly ["google", "openai", "seedream", "dashscope", "comfyui"];
 export type ImageProvider = typeof IMAGE_PROVIDERS[number];
+/** Providers supported by the first browser workbench release. */
+export declare const CLOUD_IMAGE_PROVIDERS: readonly ["google", "openai", "seedream", "dashscope"];
+export type CloudImageProvider = typeof CLOUD_IMAGE_PROVIDERS[number];
+/** One selectable output option exposed by a provider profile. */
+export interface StudioOption {
+    value: string;
+    label: string;
+}
+/** Browser-safe provider description. Credentials and endpoints never cross this boundary. */
+export interface StudioProviderProfile {
+    provider: CloudImageProvider;
+    label: string;
+    model: string;
+    configured: boolean;
+    supportsEditing: boolean;
+    ratioOptions: StudioOption[];
+    qualityOptions: StudioOption[];
+    defaultRatio: string;
+    defaultQuality: string;
+}
+/** Lightweight workspace description exposed to the client for scoping. */
+export interface StudioWorkspaceInfo {
+    workspaceId: string;
+    path: string;
+    title: string;
+    sessionIds: string[];
+}
+/** Read model and capability state for the workbench without exposing secrets. */
+export interface StudioConfigResponse {
+    providers: StudioProviderProfile[];
+    activeProvider: CloudImageProvider;
+    workspaceRoot?: string | undefined;
+    workspaces?: StudioWorkspaceInfo[] | undefined;
+}
+/** A browser-uploaded reference image used for one editing request. */
+export interface StudioEncodedReference {
+    mediaType: ImageMediaType;
+    data: string;
+    name?: string;
+}
+/** A durable image reference selected from the existing gallery. */
+export interface StudioAttachmentReference {
+    attachment: ImageAttachmentRef;
+}
+export type StudioReference = StudioEncodedReference | StudioAttachmentReference;
+/** One browser workbench generation or editing request. */
+export interface StudioGenerateRequest {
+    mode: 'generate' | 'edit';
+    provider: CloudImageProvider;
+    model: string;
+    prompt: string;
+    ratio: string;
+    quality: string;
+    reference?: StudioReference;
+    references?: StudioReference[];
+    workspaceRoot?: string | undefined;
+}
+/** One completed workbench request. */
+export interface StudioGenerateResponse {
+    attachment: ImageAttachmentRef;
+    provider: CloudImageProvider;
+    model: string;
+    prompt: string;
+    output: string;
+    createdAt: number;
+    elapsedMs: number;
+    savedTo?: string | undefined;
+}
 /** Default endpoints and base URLs. */
 export declare const DEFAULT_GOOGLE_ENDPOINT = "https://generativelanguage.googleapis.com/v1beta/interactions";
 export declare const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";

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

@@ -0,0 +1,12 @@
+/** Same-origin HTTP bridge used by the browser image workbench. */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type StudioConfigResponse, type StudioGenerateRequest, type StudioGenerateResponse } from './shared.js';
+export interface StudioRouteDeps {
+    describe(): Promise<StudioConfigResponse>;
+    generate(input: StudioGenerateRequest, signal: AbortSignal): Promise<StudioGenerateResponse>;
+    maxBodyBytes: number;
+}
+/** Serve workbench capabilities and generation requests without exposing provider credentials. */
+export declare function serveStudio(req: IncomingMessage, res: ServerResponse, deps: StudioRouteDeps): Promise<void>;
+/** Strictly validate the small untrusted workbench wire contract. */
+export declare function parseStudioGenerateRequest(value: unknown): StudioGenerateRequest;

package/lib/types/studio.d.ts

@@ -0,0 +1,8 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type Config } from './config.js';
+import { type CloudImageProvider, type StudioConfigResponse, type StudioGenerateRequest, type StudioGenerateResponse, type StudioProviderProfile } from './shared.js';
+/** Return only browser-safe capability data. */
+export declare function describeStudio(ctx: Context, config: Config): Promise<StudioConfigResponse>;
+/** Execute one validated browser workbench request using the existing provider adapters. */
+export declare function generateFromStudio(ctx: Context, config: Config, input: StudioGenerateRequest, signal: AbortSignal, fallbackWorkspaceRoot?: string | undefined): Promise<StudioGenerateResponse>;
+export declare function studioProfile(config: Config, provider: CloudImageProvider, configured: boolean): StudioProviderProfile;

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

@@ -1,3 +1,4 @@
+import type { StudioWorkspaceInfo } from './shared.js';
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 /**
  * Build the deterministic file name for a generated image:
@@ -50,3 +51,26 @@ 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[]>;
+/** Discover detailed workspace records from DSH workspace.json storage. */
+export declare function getDshWorkspacesFull(): Promise<StudioWorkspaceInfo[]>;
+/**
+ * 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.5",
+  "version": "0.3.0",
   "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope, local ComfyUI & more.",
   "type": "module",
   "author": "shanliuling",
@@ -54,13 +54,6 @@
       "platform": "web"
     }
   },
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "build": "tsc && tsdown",
-    "prepare": "pnpm run build",
-    "test": "vitest run",
-    "pack:check": "pnpm pack --dry-run"
-  },
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
   },
@@ -130,5 +123,13 @@
     "unrun": "^0.3.1",
     "vitest": "^4.1.8"
   },
-  "packageManager": "pnpm@11.7.0"
-}
+  "dependencies": {
+    "lucide-react": "^1.38.0"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsc && tsdown",
+    "test": "vitest run",
+    "pack:check": "pnpm pack --dry-run"
+  }
+}