@dickpy/dsh-imagegen 1.5.3 → 1.5.5

package/src/history-store.ts

@@ -12,6 +12,7 @@ import { promises as fs } from 'node:fs'
 import { homedir } from 'node:os'
 import path from 'node:path'
 import { HISTORY_MAX, type GenerateMode, type HistoryEntry, type HistoryEntryInput } from './protocol.ts'
+import { notifyImageSaved } from './storage-sync.ts'
 
 const HISTORY_DIR = path.join(homedir(), '.dsh', 'dsh-imagegen')
 const INDEX_PATH = path.join(HISTORY_DIR, 'index.json')
@@ -56,6 +57,7 @@ interface StoredEntry {
   projectName?: string
   slotKey?: string
   slotLabel?: string
+  canvas?: HistoryEntryInput['canvas']
 }
 
 /** The index.json shape. */
@@ -174,6 +176,7 @@ function toWire(entry: StoredEntry): HistoryEntry {
     ...entry.projectName === undefined ? {} : { projectName: entry.projectName },
     ...entry.slotKey === undefined ? {} : { slotKey: entry.slotKey },
     ...entry.slotLabel === undefined ? {} : { slotLabel: entry.slotLabel },
+    ...entry.canvas === undefined ? {} : { canvas: entry.canvas },
   }
 }
 
@@ -194,6 +197,7 @@ export async function appendHistory(input: HistoryEntryInput): Promise<HistoryEn
         const image = input.images[index]!
         const file = `${prefix}-${index}.${extensionOf(image.mime)}`
         await fs.writeFile(path.join(IMAGES_DIR, file), Buffer.from(image.b64, 'base64'))
+        notifyImageSaved('history', path.join(IMAGES_DIR, file))
         storedImages.push({
           file,
           mime: image.mime,
@@ -225,6 +229,7 @@ export async function appendHistory(input: HistoryEntryInput): Promise<HistoryEn
       ...input.projectName === undefined ? {} : { projectName: input.projectName },
       ...input.slotKey === undefined ? {} : { slotKey: input.slotKey },
       ...input.slotLabel === undefined ? {} : { slotLabel: input.slotLabel },
+      ...input.canvas === undefined ? {} : { canvas: input.canvas },
     }
     const merged = [entry, ...await readIndex()]
     const kept = merged.slice(0, HISTORY_MAX)

package/src/index.ts

@@ -8,9 +8,10 @@
  */
 
 import type { Context } from '@deepseek-ai/cordis'
+import { readFileSync } from 'node:fs'
+import path from 'node:path'
 import { installSettingsSectionCompat, settingsNamespaceCompat } from './settings-compat.ts'
-import z from 'schemastery'
-// Type-only: pulls the webServer Context merge (route registration).
+import z from 'schemastery'// Type-only: pulls the webServer Context merge (route registration).
 import type {} from '@deepseek-ai/dsh-host-webserver'
 // Type-only: pulls the systemPrompt Context merge (announcement section).
 import type {} from '@deepseek-ai/dsh-system-prompt'
@@ -21,6 +22,18 @@ import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment'
 import { IMAGEGEN_SETTINGS_NAMESPACE, type ChannelConfig, type ModelMapping } from './protocol.ts'
 import { makeRoutes, type SettingsSeam } from './routes.ts'
 import { syncAllTemplates } from './templates-store.ts'
+import { setStorageSyncHandler, putObject, type StorageSyncConfig } from './storage-sync.ts'
+
+/** Content type for a saved image file name (object uploads). */
+function mimeOfPath(filePath: string): string {
+  switch (path.extname(filePath).toLowerCase()) {
+    case '.jpg':
+    case '.jpeg': return 'image/jpeg'
+    case '.webp': return 'image/webp'
+    case '.gif': return 'image/gif'
+    default: return 'image/png'
+  }
+}
 import { ImageGenerationRuntime, type ChannelsView, type RuntimeChannel } from './generation-runtime.ts'
 import { registerAgentImageTools } from './agent-image-tools.ts'
 import { registerEditImageCommand } from './edit-image-command.ts'
@@ -42,6 +55,7 @@ export { latestSessionImage, registerEditImageCommand } from './edit-image-comma
 export { appendGallery, clearGallery, listGallery, readGalleryImage, removeGallery, updateGalleryTags } from './gallery-store.ts'
 export { listTemplates, readTemplateImage, refreshTemplates, sampleTemplates, syncAllTemplates, clearTemplateMemo } from './templates-store.ts'
 export { addTemplateFavorite, clearTemplateFavoritesMemo, listTemplateFavorites, removeTemplateFavorite } from './template-favorites.ts'
+export { putObject, setStorageSyncHandler, testStorage, type StorageSyncConfig } from './storage-sync.ts'
 export { checkForUpdate, clearUpdateCache, compareVersions, CURRENT_VERSION, installUpdate, profileFromProcess } from './updater.ts'
 
 /** The branded settings namespace of this plugin (the card edits it). */
@@ -75,6 +89,22 @@ export interface Config {
   promptApiKey?: string
   /** Chat model used to expand short image prompts. */
   promptModel?: string
+  /** Sync saved images to an S3-compatible object store (COS / OSS / Qiniu S3 …). */
+  storageEnabled?: boolean
+  /** S3-compatible endpoint URL including the bucket (virtual-hosted or path style). */
+  storageEndpoint?: string
+  /** Provider region for SigV4 scope, e.g. ap-guangzhou / oss-cn-hangzhou. */
+  storageRegion?: string
+  /** Object key prefix, default 'dsh-imagegen'. */
+  storagePrefix?: string
+  /** S3 access key id. */
+  storageAccessKey?: string
+  /** S3 secret access key (stored redacted). */
+  storageSecretKey?: string
+  /** Upload gallery additions (default on when storage is enabled). */
+  storageSyncGallery?: boolean
+  /** Also upload history images. */
+  storageSyncHistory?: boolean
   /* ----- deprecated legacy single-endpoint fields (migrated to channels) ----- */
   /** Legacy base URL; synthesized into the default channel on upgrade. */
   apiUrl?: string
@@ -103,6 +133,14 @@ export const Config: z<Config> = z.object({
   promptApiUrl: z.string().default(''),
   promptApiKey: z.string().role('secret').default(''),
   promptModel: z.string().default(''),
+  storageEnabled: z.boolean().default(false),
+  storageEndpoint: z.string().default(''),
+  storageRegion: z.string().default(''),
+  storagePrefix: z.string().default('dsh-imagegen'),
+  storageAccessKey: z.string().default(''),
+  storageSecretKey: z.string().role('secret').default(''),
+  storageSyncGallery: z.boolean().default(true),
+  storageSyncHistory: z.boolean().default(false),
   apiUrl: z.string().default(''),
   apiKey: z.string().role('secret').default(''),
   imageModels: z.array(z.string()).default([]),
@@ -175,6 +213,7 @@ export interface EffectiveConfig {
   promptApiUrl: string
   promptApiKey: string
   promptModel: string
+  storage: StorageSyncConfig & { enabled: boolean; syncGallery: boolean; syncHistory: boolean }
 }
 
 /**
@@ -182,7 +221,7 @@ export interface EffectiveConfig {
  * @param ctx - host plugin context carrying webServer/systemPrompt.
  * @param config - resolved plugin config (schema defaults applied by the loader).
  */
-export function apply(ctx: Context, config?: Config): void {
+export function apply(ctx: Context, config?: Config): (() => void) | void {
   // The live source the surfaces read: the settings section once the settings
   // service is attached, the composition entry otherwise.
   let current: () => Config = () => config ?? {}
@@ -226,6 +265,16 @@ export function apply(ctx: Context, config?: Config): void {
       promptApiUrl: typeof value.promptApiUrl === 'string' ? value.promptApiUrl.trim() : '',
       promptApiKey: typeof value.promptApiKey === 'string' ? value.promptApiKey.trim() : '',
       promptModel: typeof value.promptModel === 'string' ? value.promptModel.trim() : '',
+      storage: {
+        enabled: value.storageEnabled ?? false,
+        endpoint: typeof value.storageEndpoint === 'string' ? value.storageEndpoint.trim() : '',
+        region: typeof value.storageRegion === 'string' ? value.storageRegion.trim() : '',
+        accessKey: typeof value.storageAccessKey === 'string' ? value.storageAccessKey.trim() : '',
+        secretKey: typeof value.storageSecretKey === 'string' ? value.storageSecretKey.trim() : '',
+        prefix: typeof value.storagePrefix === 'string' && value.storagePrefix.trim() !== '' ? value.storagePrefix.trim() : 'dsh-imagegen',
+        syncGallery: value.storageSyncGallery ?? true,
+        syncHistory: value.storageSyncHistory ?? false,
+      },
     }
   }
 
@@ -236,6 +285,21 @@ export function apply(ctx: Context, config?: Config): void {
     return { channels: value.channels, defaultChannelId: value.defaultChannelId }
   }
 
+  // Object-storage sync: the image stores announce every file they write; the
+  // handler resolves the live settings and uploads when enabled. Fire and
+  // forget — a sync failure never blocks the save path.
+  setStorageSyncHandler((kind, filePath) => {
+    const storage = resolve().storage
+    if (!storage.enabled || !storage.endpoint.trim() || storage.secretKey.trim() === '') return
+    if (kind === 'gallery' && !storage.syncGallery) return
+    if (kind === 'history' && !storage.syncHistory) return
+    const key = `${storage.prefix}/${kind === 'gallery' ? 'gallery' : 'images'}/${path.basename(filePath)}`
+    const data = readFileSync(filePath)
+    void putObject(storage, key, data, mimeOfPath(filePath)).catch(() => {
+      // Best-effort sync: surfaced through the settings test, never fatal here.
+    })
+  })
+
   // Browser endpoints and Agent tools share the exact same serial queue. This
   // keeps image persistence, cancellation, and retries coherent across both
   // entry points; Agent tools wait for their task result by default and render
@@ -276,6 +340,7 @@ export function apply(ctx: Context, config?: Config): void {
           attachments: sctx.attachments,
           pendingConversationImages,
           runtime,
+          resolveStorage: () => resolve().storage,
         })
         const disposers = routes.map(route => ctx.webServer.register(route))
         // Background template sync: the upstream sources update on their own
@@ -354,4 +419,6 @@ export function apply(ctx: Context, config?: Config): void {
   // Initial registration from the composition entry (covers deployments with
   // no settings service, whose installSettingsSection never fires its hooks).
   sync()
+
+  return () => { setStorageSyncHandler(undefined) }
 }

package/src/protocol.ts

@@ -8,7 +8,7 @@
 export const IMAGEGEN_SETTINGS_NAMESPACE = 'dsh-imagegen'
 
 /** Published package version shared by the host updater and the client UI. */
-export const PLUGIN_VERSION = '1.5.3'
+export const PLUGIN_VERSION = '1.5.5'
 
 /** Same-origin route family (loopback-only, mirroring the dsh-ssh fence). */
 export const SETTINGS_API = {
@@ -54,6 +54,14 @@ export const TASK_API = {
   retry: '/api/dsh-imagegen/tasks/retry',
 } as const
 
+/** Reveal the host data directory (saved images) in the OS file manager. */
+export const DATA_FOLDER_API = '/api/dsh-imagegen/data-folder/open' as const
+
+/** Probe the configured S3-compatible object storage. */
+export const STORAGE_API = {
+  test: '/api/dsh-imagegen/storage/test',
+} as const
+
 /** Host-mediated GitHub Release update routes. */
 export const UPDATE_API = {
   check: '/api/dsh-imagegen/update/check',
@@ -88,6 +96,18 @@ export const GALLERY_API = {
   image: '/api/dsh-imagegen/gallery/image',
 } as const
 
+/** Host-persisted infinite canvas projects and their content-addressed assets. */
+export const CANVAS_API = {
+  list: '/api/dsh-imagegen/canvas/list',
+  create: '/api/dsh-imagegen/canvas/create',
+  read: '/api/dsh-imagegen/canvas/read',
+  save: '/api/dsh-imagegen/canvas/save',
+  remove: '/api/dsh-imagegen/canvas/remove',
+  assetUpload: '/api/dsh-imagegen/canvas/asset/upload',
+  assetImport: '/api/dsh-imagegen/canvas/asset/import',
+  asset: '/api/dsh-imagegen/canvas/asset',
+} as const
+
 /** Maximum number of history entries retained host-side (oldest evicted). */
 export const HISTORY_MAX = 50
 
@@ -226,6 +246,100 @@ export interface TemplateFavorite {
 /** Generation modes. */
 export type GenerateMode = 'text' | 'edit'
 
+/** Origin information carried by a generation started from the canvas. */
+export interface CanvasTaskMeta {
+  canvasId: string
+  sourceNodeId?: string
+  /** Legacy v1 annotation workflow; kept so old history entries still parse. */
+  annotationNodeId?: string
+  parentNodeId?: string
+  placement?: 'right' | 'below'
+}
+
+/** One image asset referenced by a canvas node. */
+export interface CanvasAssetRef {
+  assetId: string
+  url: string
+  mime: string
+  bytes: number
+  width: number
+  height: number
+  origin: 'upload' | 'history' | 'gallery' | 'generated'
+  originId?: string
+  entryId?: string
+  imageIndex?: number
+}
+
+export type CanvasNodeType = 'image' | 'text' | 'config'
+
+export interface CanvasViewport {
+  x: number
+  y: number
+  /** Zoom factor. */
+  k: number
+}
+
+/** Free-form per-node state, mirroring the node-graph canvas model. */
+export interface CanvasNodeMetadata {
+  /** Image nodes: the rendered asset. */
+  asset?: CanvasAssetRef
+  status?: 'idle' | 'generating' | 'success' | 'error'
+  error?: string
+  /** Config/image nodes: generation settings. */
+  prompt?: string
+  model?: string
+  size?: string
+  quality?: string
+  /** Config nodes: how many images to generate (1-4). */
+  count?: number
+  /** Config nodes: generation mode (image) or plain writing (text). */
+  mode?: 'image' | 'text'
+  taskId?: string
+  sourceNodeId?: string
+  /** Text nodes. */
+  text?: string
+  fontSize?: number
+}
+
+export interface CanvasNode {
+  id: string
+  type: CanvasNodeType
+  title: string
+  x: number
+  y: number
+  width: number
+  height: number
+  metadata?: CanvasNodeMetadata
+}
+
+export interface CanvasConnection {
+  id: string
+  fromNodeId: string
+  toNodeId: string
+}
+
+export interface CanvasDocument {
+  version: 2
+  id: string
+  title: string
+  revision: number
+  viewport: CanvasViewport
+  background: 'dots' | 'lines' | 'blank'
+  nodes: CanvasNode[]
+  connections: CanvasConnection[]
+  createdAt: number
+  updatedAt: number
+}
+
+export interface CanvasSummary {
+  id: string
+  title: string
+  revision: number
+  nodeCount: number
+  createdAt: number
+  updatedAt: number
+}
+
 /** Metadata shared by the ecommerce product-set workflow. */
 export interface EcommerceTaskMeta {
   workflow?: 'ecommerce'
@@ -257,6 +371,8 @@ export interface ProductSetDraft {
   category: string
   platform: string
   language: string
+  /** Custom copy language when language is 'custom'. */
+  customLanguage?: string
   size: string
   productName: string
   sellingPoints: string
@@ -311,6 +427,8 @@ export interface GenerateRequest extends EcommerceTaskMeta {
   comparisonId?: string
   /** All model aliases selected for one comparison run. */
   comparisonModels?: string[]
+  /** Optional canvas lineage metadata. */
+  canvas?: CanvasTaskMeta
 }
 
 /** One generated image, normalized host-side to base64 so the browser never
@@ -428,6 +546,7 @@ export interface HistoryEntry extends EcommerceTaskMeta {
   comparisonId?: string
   /** Model aliases included in the comparison run. */
   comparisonModels?: string[]
+  canvas?: CanvasTaskMeta
 }
 
 /** A history entry the client submits for persistence (images still carry base64). */
@@ -451,4 +570,5 @@ export interface HistoryEntryInput extends EcommerceTaskMeta {
   comparisonId?: string
   /** Model aliases included in the comparison run. */
   comparisonModels?: string[]
+  canvas?: CanvasTaskMeta
 }