@dickpy/dsh-imagegen 1.1.0 → 1.2.1

package/src/client/settings-card.module.css

@@ -224,6 +224,25 @@
   outline: none;
 }
 
+.textarea,
+.textareaInvalid {
+  min-height: 70px;
+  resize: vertical;
+  padding: 8px 12px;
+  border-radius: 8px;
+  background: var(--dsw-alias-bg-layer-3);
+  font: inherit;
+  font-size: 13px;
+  line-height: 1.5;
+  color: var(--dsw-alias-label-primary);
+  outline: none;
+}
+
+.textarea { border: 1px solid var(--dsw-alias-border-l2); }
+.textareaInvalid { border: 1px solid var(--dsw-alias-label-error); }
+.textarea:focus-visible { border-color: var(--dsw-alias-brand-primary); }
+.textarea:disabled { color: var(--dsw-alias-label-tertiary); cursor: default; }
+
 .hint,
 .invalid {
   margin: 0;
@@ -267,6 +286,134 @@
   line-height: 1.5;
 }
 
+.modelSection {
+  padding: 2px 0 14px;
+}
+
+.sectionHeader {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 12px;
+}
+
+.sectionHeader .sectionHint {
+  max-width: 430px;
+}
+
+.modelSummary {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 6px;
+  margin-top: 12px;
+}
+
+.modelChip {
+  display: inline-flex;
+  align-items: center;
+  max-width: 100%;
+  gap: 5px;
+  padding: 3px 5px 3px 8px;
+  border: 1px solid var(--dsw-alias-border-l2);
+  border-radius: 6px;
+  background: var(--dsw-alias-bg-layer-3);
+  color: var(--dsw-alias-label-primary);
+  font-family: var(--dsw-font-family-mono, monospace);
+  font-size: 12px;
+  line-height: 1.5;
+}
+
+.modelChip > span {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.modelChip button {
+  appearance: none;
+  border: 0;
+  border-radius: 4px;
+  width: 18px;
+  height: 18px;
+  padding: 0;
+  background: transparent;
+  color: var(--dsw-alias-label-tertiary);
+  font: inherit;
+  line-height: 18px;
+  cursor: pointer;
+}
+
+.modelChip button:hover:not(:disabled) { color: var(--dsw-alias-label-primary); background: var(--dsw-alias-bg-module-platform); }
+.modelChip button:disabled { cursor: default; opacity: 0.45; }
+
+.addModel {
+  appearance: none;
+  min-height: 28px;
+  border: 1px dashed var(--dsw-alias-border-l2);
+  border-radius: 6px;
+  padding: 0 9px;
+  background: transparent;
+  color: var(--dsw-alias-label-secondary);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+
+.addModel:hover:not(:disabled) { color: var(--dsw-alias-brand-primary); border-color: var(--dsw-alias-brand-primary); }
+.addModel:disabled { opacity: 0.45; cursor: default; }
+
+.manualModelRow {
+  display: flex;
+  gap: 8px;
+  margin-top: 10px;
+}
+
+.manualModelRow .input { min-width: 0; flex: 1; }
+
+.disclosure {
+  width: 100%;
+  appearance: none;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  border: 0;
+  border-top: 1px solid var(--dsw-alias-border-l2);
+  padding: 13px 0;
+  background: none;
+  color: var(--dsw-alias-label-primary);
+  font: inherit;
+  font-size: 13px;
+  font-weight: 500;
+  text-align: left;
+  cursor: pointer;
+}
+
+.disclosure > span:nth-child(2) { margin-left: auto; color: var(--dsw-alias-label-tertiary); font-size: 12px; font-weight: 400; }
+.disclosure > span:last-child { color: var(--dsw-alias-label-tertiary); }
+.disclosure:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 2px; }
+
+.optionalContent {
+  padding: 0 0 8px;
+}
+
+.inlineDisclosure {
+  appearance: none;
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  margin-top: 12px;
+  padding: 0;
+  border: 0;
+  background: none;
+  color: var(--dsw-alias-label-secondary);
+  font: inherit;
+  font-size: 12px;
+  cursor: pointer;
+}
+
+.inlineDisclosure:hover { color: var(--dsw-alias-label-primary); }
+
 .modelFetchRow {
   display: flex;
   gap: 8px;
@@ -289,6 +436,39 @@
 .modelFetch:disabled { opacity: 0.5; cursor: default; }
 .modelChoices { min-width: 0; flex: 1; padding: 0 8px; }
 
+.modelCandidateList {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px 10px;
+  margin-top: 10px;
+}
+
+.modelCandidateLabel {
+  width: 100%;
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 12px;
+}
+
+.modelCandidate {
+  appearance: none;
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  min-width: 0;
+  color: var(--dsw-alias-label-secondary);
+  font-size: 12px;
+  line-height: 1.5;
+  cursor: pointer;
+  padding: 3px 6px;
+  border: 1px solid transparent;
+  border-radius: 5px;
+  background: var(--dsw-alias-bg-layer-3);
+  font: inherit;
+}
+
+.modelCandidate input { margin: 0; }
+.modelCandidate[data-selected] { border-color: var(--dsw-alias-border-l2); color: var(--dsw-alias-label-primary); }
+
 /* --- footer (mirror of the official card footer) ------------------------------ */
 
 .footer {

package/src/client/settings-form.ts

@@ -102,6 +102,18 @@ export function textField(field: string): FieldSpec {
   }
 }
 
+/** A newline/comma-separated model list, persisted as a normalized string array. */
+export function stringListField(field: string): FieldSpec {
+  return {
+    field,
+    format: value => Array.isArray(value) ? value.filter((item): item is string => typeof item === 'string').join('\n') : '',
+    parse: (text) => {
+      const values = [...new Set(text.split(/[\n,]/).map(item => item.trim()).filter(Boolean))]
+      return values.length === 0 ? { kind: 'clear' } : { kind: 'set', value: values }
+    },
+  }
+}
+
 /** A boolean field, edited through true/false draft text. */
 export function booleanField(field: string): FieldSpec {
   return {

package/src/client/settings-scope.ts

@@ -20,8 +20,10 @@ import { SETTINGS_API } from '../protocol.ts'
 export interface ImageGenConfig {
   enabled?: boolean
   announceToAgent?: boolean
+  allowAgentImageGeneration?: boolean
   apiUrl?: string
   apiKey?: string
+  imageModels?: string[]
   promptApiUrl?: string
   promptApiKey?: string
   promptModel?: string

package/src/engine.ts

@@ -69,6 +69,27 @@ const GROK_ASPECT_ALIASES: Readonly<Record<string, string>> = {
   '21:9': '20:9',
 }
 
+/**
+ * One request-scoped timeout that is cleared as soon as its fetch settles.
+ * AbortSignal.timeout() cannot be disposed early; using it inside a long-lived
+ * task queue leaves an otherwise idle Node process holding every timeout.
+ */
+function requestSignal(source: AbortSignal | undefined, timeoutMs: number): { signal: AbortSignal; dispose: () => void } {
+  const controller = new AbortController()
+  const abortFromSource = () => { controller.abort(source?.reason) }
+  if (source?.aborted === true) abortFromSource()
+  else source?.addEventListener('abort', abortFromSource, { once: true })
+  const timeout = setTimeout(() => { controller.abort(new DOMException('The operation timed out.', 'TimeoutError')) }, timeoutMs)
+  timeout.unref()
+  return {
+    signal: controller.signal,
+    dispose: () => {
+      clearTimeout(timeout)
+      source?.removeEventListener('abort', abortFromSource)
+    },
+  }
+}
+
 /** Content-type extension hints for URL-fetched images. */
 function mimeOfExtension(path: string): string | undefined {
   const match = /\.([a-z0-9]+)$/i.exec(path)
@@ -181,16 +202,19 @@ async function normalizeItem(
     if (parsed === undefined) throw new ImageGenError('upstream returned a malformed data: url')
     return { b64: parsed.base64, mime: parsed.mime, revisedPrompt }
   }
+  const budget = requestSignal(undefined, IMAGE_FETCH_TIMEOUT_MS)
   let response: Response
   try {
     response = await fetch(url, {
       headers: {
         ...upstream.apiKey === '' ? {} : { authorization: `Bearer ${upstream.apiKey}` },
       },
-      signal: AbortSignal.timeout(IMAGE_FETCH_TIMEOUT_MS),
+      signal: budget.signal,
     })
   } catch (error) {
     throw new ImageGenError(`failed to fetch the generated image url: ${error instanceof Error ? error.message : String(error)}`)
+  } finally {
+    budget.dispose()
   }
   if (!response.ok) {
     throw new ImageGenError(`failed to fetch the generated image url: HTTP ${response.status}`)
@@ -259,13 +283,14 @@ async function requestOneImage(
     body = JSON.stringify({ prompt: request.prompt, ...params } as Record<string, unknown>)
   }
 
+  const budget = requestSignal(signal, UPSTREAM_TIMEOUT_MS)
   let response: Response
   try {
     response = await fetch(`${baseUrl}/images/${request.mode === 'edit' ? 'edits' : 'generations'}`, {
       method: 'POST',
       headers,
       body,
-      signal: signal === undefined ? AbortSignal.timeout(UPSTREAM_TIMEOUT_MS) : AbortSignal.any([signal, AbortSignal.timeout(UPSTREAM_TIMEOUT_MS)]),
+      signal: budget.signal,
     })
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error)
@@ -273,6 +298,8 @@ async function requestOneImage(
       throw new ImageGenError('上游接口响应超时（240 秒）', 'upstream-timeout')
     }
     throw new ImageGenError(`无法连接上游接口：${message}`, 'upstream-unreachable')
+  } finally {
+    budget.dispose()
   }
 
   let payload: unknown

package/src/generation-runtime.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared host-side generation runtime. Both the browser routes and Agent tools
+ * submit to this one queue so persisted history and cancellation semantics stay
+ * identical regardless of where a request originated.
+ */
+
+import { randomUUID } from 'node:crypto'
+import { generateImage, type UpstreamConfig } from './engine.ts'
+import { appendHistory } from './history-store.ts'
+import type { GenerateRequest, GenerateResult, HistoryEntry, HistoryEntryInput } from './protocol.ts'
+import { GenerationTaskQueue } from './task-queue.ts'
+
+export interface HistorySink {
+  append(entry: HistoryEntryInput): Promise<HistoryEntry[]>
+}
+
+export class ImageGenerationRuntime {
+  readonly queue: GenerationTaskQueue
+
+  constructor(
+    private readonly resolve: () => UpstreamConfig,
+    private readonly history: HistorySink = { append: appendHistory },
+  ) {
+    this.queue = new GenerationTaskQueue((request, signal) => this.run(request, signal))
+  }
+
+  async run(request: GenerateRequest, signal?: AbortSignal): Promise<GenerateResult> {
+    const result = await generateImage(this.resolve(), request, { signal })
+    try {
+      const history = await this.history.append({
+        id: randomUUID(),
+        createdAt: Date.now(),
+        mode: request.mode,
+        model: request.model,
+        prompt: request.prompt,
+        size: request.size,
+        quality: request.quality,
+        detail: request.detail,
+        n: request.n,
+        images: result.images,
+        ...request.refName === undefined ? {} : { refName: request.refName },
+      })
+      return { ...result, history }
+    } catch (error) {
+      return { ...result, historyError: error instanceof Error ? error.message : String(error) }
+    }
+  }
+}

package/src/image-models.ts

@@ -0,0 +1,19 @@
+/**
+ * Image-model configuration shared by the host, panel, and Agent tools.
+ * `/models` exposes candidates only: the configured list is the explicit
+ * allow-list because OpenAI-compatible gateways rarely advertise modalities.
+ */
+
+export const DEFAULT_IMAGE_MODELS = ['gpt-image-2', 'grok-imagine-image'] as const
+
+/** Normalize user-entered model identifiers and retain a usable legacy default. */
+export function normalizeImageModels(value: unknown): string[] {
+  const candidates = Array.isArray(value) ? value : []
+  const unique = new Set<string>()
+  for (const candidate of candidates) {
+    if (typeof candidate !== 'string') continue
+    const model = candidate.trim()
+    if (model !== '') unique.add(model)
+  }
+  return unique.size > 0 ? [...unique] : [...DEFAULT_IMAGE_MODELS]
+}

package/src/index.ts

@@ -13,8 +13,13 @@ import z from 'schemastery'
 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'
+import type {} from '@deepseek-ai/dsh-tools'
+import type {} from '@deepseek-ai/dsh-attachment'
 import { IMAGEGEN_SETTINGS_NAMESPACE } from './protocol.ts'
 import { makeRoutes, type SettingsSeam } from './routes.ts'
+import { ImageGenerationRuntime } from './generation-runtime.ts'
+import { registerAgentImageTools } from './agent-image-tools.ts'
+import { DEFAULT_IMAGE_MODELS, normalizeImageModels } from './image-models.ts'
 
 /** Stable cordis plugin name. */
 export const name = 'imagegen'
@@ -26,6 +31,8 @@ export const inject = ['webServer', 'systemPrompt']
 // contract only requires name / inject / Config / apply.
 export { makeRoutes } from './routes.ts'
 export { generateImage, ImageGenError } from './engine.ts'
+export { ImageGenerationRuntime } from './generation-runtime.ts'
+export { registerAgentImageTools } from './agent-image-tools.ts'
 export { appendGallery, clearGallery, listGallery, readGalleryImage, removeGallery, updateGalleryTags } from './gallery-store.ts'
 export { listTemplates, readTemplateImage, refreshTemplates, clearTemplateMemo } from './templates-store.ts'
 export { checkForUpdate, clearUpdateCache, compareVersions, CURRENT_VERSION, installUpdate, profileFromProcess } from './updater.ts'
@@ -39,10 +46,14 @@ export interface Config {
   enabled?: boolean
   /** Announce the plugin in every agent's system prompt. */
   announceToAgent?: boolean
+  /** Allow Agents to submit and retrieve image-generation tasks. */
+  allowAgentImageGeneration?: boolean
   /** Base URL of the OpenAI-compatible endpoint, e.g. https://api.openai.com/v1 */
   apiUrl?: string
   /** Bearer API key (stored as a secret field on the settings seam). */
   apiKey?: string
+  /** Explicit allow-list of image models selected for this API endpoint. */
+  imageModels?: string[]
   /** Optional OpenAI-compatible chat endpoint for prompt enhancement. */
   promptApiUrl?: string
   /** Optional secret for the prompt enhancement endpoint. */
@@ -54,8 +65,10 @@ export interface Config {
 export const Config: z<Config> = z.object({
   enabled: z.boolean().default(true),
   announceToAgent: z.boolean().default(true),
+  allowAgentImageGeneration: z.boolean().default(true),
   apiUrl: z.string().default(''),
   apiKey: z.string().role('secret').default(''),
+  imageModels: z.array(z.string()).default([...DEFAULT_IMAGE_MODELS]),
   promptApiUrl: z.string().default(''),
   promptApiKey: z.string().role('secret').default(''),
   promptModel: z.string().default(''),
@@ -64,19 +77,27 @@ export const Config: z<Config> = z.object({
 /** Schema defaults, re-read for hand-built contexts (the loader applies them normally). */
 const DEFAULT_ENABLED = true
 const DEFAULT_ANNOUNCE = true
+const DEFAULT_ALLOW_AGENT_IMAGE_GENERATION = true
 
 /** Order of the announcement section within the tool-guidance band. */
 const SECTION_ORDER = 150
 
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-export const IMAGEGEN_GUIDANCE = '本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：对接 OpenAI 兼容图像生成 API（模型 gpt-image-2 / grok-imagine-image），支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok 模型按官方 JSON image_url 协议发送）；API 地址与密钥在 GUI「设置 → 插件 → 可配置」中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载；可一键把满意的图片加入「画廊」（工作台顶部 文生图 / 图生图 / 画廊 三个标签页，画廊在右侧展示，收藏持久化在本地 ~/.dsh/dsh-imagegen/gallery/）。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条 gpt-image-2 提示词案例（含中文标题、分类、参考图，可搜索/按分类筛选），参考图经宿主代理按需缓存到本地；用户可一键把模板提示词填入提示词框再生成。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / gpt-image-2 / grok-imagine-image / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。'
+export const IMAGEGEN_GUIDANCE = '本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：对接 OpenAI 兼容图像生成 API，模型由用户在「设置 → 插件 → AI 生图」中检测或手动配置的生图模型列表决定；支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送）。API 地址与密钥在 GUI 设置中配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用已配置的生图模型；模型出现在 /models 中不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选与复用。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；任务后台异步执行，完成后插件会自动唤醒原对话，并以可直接查看和复用的图片附件回贴结果，因此不要反复轮询。仅在用户明确要求进度或需要恢复任务时，才使用 `get_image_generation_task` 查询状态。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。'
+
+/** Add the live allow-list so an Agent can honor a user's model choice. */
+function guidanceFor(imageModels: string[]): string {
+  return `${IMAGEGEN_GUIDANCE} 当前允许调用的生图模型：${imageModels.join('、')}。用户指定其中某个模型时，工具参数 model 必须使用该精确名称；未指定时使用列表中的第一个。`
+}
 
 /** Effective config (schema defaults applied). */
 interface EffectiveConfig {
   enabled: boolean
   announceToAgent: boolean
+  allowAgentImageGeneration: boolean
   apiUrl: string
   apiKey: string
+  imageModels: string[]
   promptApiUrl: string
   promptApiKey: string
   promptModel: string
@@ -96,14 +117,24 @@ export function apply(ctx: Context, config?: Config): void {
     return {
       enabled: value.enabled ?? DEFAULT_ENABLED,
       announceToAgent: value.announceToAgent ?? DEFAULT_ANNOUNCE,
+      allowAgentImageGeneration: value.allowAgentImageGeneration ?? DEFAULT_ALLOW_AGENT_IMAGE_GENERATION,
       apiUrl: value.apiUrl ?? '',
       apiKey: value.apiKey ?? '',
+      imageModels: normalizeImageModels(value.imageModels),
       promptApiUrl: value.promptApiUrl ?? '',
       promptApiKey: value.promptApiKey ?? '',
       promptModel: value.promptModel ?? '',
     }
   }
 
+  // Browser endpoints and Agent tools share the exact same serial queue. This
+  // keeps image persistence, cancellation, and retries coherent across both
+  // entry points while a tool call itself returns immediately with a task id.
+  const runtime = new ImageGenerationRuntime(() => {
+    const value = resolve()
+    return { apiUrl: value.apiUrl, apiKey: value.apiKey }
+  })
+
   // The route family mounts once, gated on the settings seam (the bridge
   // serves it; without the seam there is nothing to expose). Route handlers
   // read resolve() per request, so config edits apply live. The settings
@@ -127,6 +158,8 @@ export function apply(ctx: Context, config?: Config): void {
               model: value.promptModel,
             }
           },
+          resolveImageModels: () => resolve().imageModels,
+          runtime,
         })
         const disposers = routes.map(route => ctx.webServer.register(route))
         return () => { for (const dispose of disposers) dispose() }
@@ -135,6 +168,19 @@ export function apply(ctx: Context, config?: Config): void {
     )
   })
 
+  ctx.inject(['tools', 'attachments'], (tctx) => {
+    tctx.effect(() => registerAgentImageTools(tctx, runtime, () => {
+      const value = resolve()
+      return {
+        enabled: value.enabled,
+        allowAgentImageGeneration: value.allowAgentImageGeneration,
+        apiUrl: value.apiUrl,
+        apiKey: value.apiKey,
+        imageModels: value.imageModels,
+      }
+    }), 'dsh-imagegen: agent image tools')
+  })
+
   // System-prompt announcement (toggled by settings changes).
   let disposeSection: (() => void) | undefined
   const sync = (): void => {
@@ -147,7 +193,7 @@ export function apply(ctx: Context, config?: Config): void {
     disposeSection = ctx.systemPrompt.section({
       name: 'plugin:dsh-imagegen',
       order: SECTION_ORDER,
-      text: IMAGEGEN_GUIDANCE,
+      text: guidanceFor(value.imageModels),
     })
   }
 

package/src/prompt-enhancer.ts

@@ -6,6 +6,12 @@ export interface PromptModelConfig {
   model: string
 }
 
+/** Credentials shared by OpenAI-compatible `/models` discovery. */
+export interface ModelListConfig {
+  apiUrl: string
+  apiKey: string
+}
+
 function endpoint(base: string, suffix: string): string {
   return `${base.replace(/\/+$/, '')}${suffix}`
 }
@@ -28,17 +34,23 @@ async function responseJson(response: Response): Promise<Record<string, unknown>
   return body as Record<string, unknown>
 }
 
-/** List chat models exposed by an OpenAI-compatible endpoint. */
-export async function listPromptModels(config: PromptModelConfig): Promise<string[]> {
-  if (config.apiUrl.trim() === '') throw new Error('prompt enhancement API URL is required')
+/** List candidates exposed by an OpenAI-compatible endpoint. */
+export async function listOpenAIModels(config: ModelListConfig): Promise<string[]> {
+  if (config.apiUrl.trim() === '') throw new Error('API URL is required')
   const response = await fetch(endpoint(config.apiUrl, '/models'), { headers: headers(config.apiKey) })
   const body = await responseJson(response)
   const data = Array.isArray(body.data) ? body.data : []
-  return data
-    .flatMap(item => item !== null && typeof item === 'object' && typeof (item as { id?: unknown }).id === 'string' ? [(item as { id: string }).id] : [])
+  return [...new Set(data
+    .flatMap(item => item !== null && typeof item === 'object' && typeof (item as { id?: unknown }).id === 'string' ? [(item as { id: string }).id.trim()] : [])
+    .filter(Boolean))]
     .sort((a, b) => a.localeCompare(b))
 }
 
+/** List chat models exposed by an OpenAI-compatible endpoint. */
+export async function listPromptModels(config: PromptModelConfig): Promise<string[]> {
+  return listOpenAIModels(config)
+}
+
 /** Expand a concise image request into a production-ready image prompt. */
 export async function enhancePrompt(config: PromptModelConfig, prompt: string): Promise<string> {
   if (config.apiUrl.trim() === '' || config.model.trim() === '') throw new Error('prompt enhancement model is not configured')

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.1.0'
+export const PLUGIN_VERSION = '1.2.1'
 
 /** Same-origin route family (loopback-only, mirroring the dsh-ssh fence). */
 export const SETTINGS_API = {
@@ -25,6 +25,11 @@ export const PROMPT_ENHANCE_API = {
   enhance: '/api/dsh-imagegen/prompt-enhance',
 } as const
 
+/** Host-mediated candidate discovery for the configured image API. */
+export const IMAGE_MODEL_API = {
+  models: '/api/dsh-imagegen/image-models',
+} as const
+
 /** Host-resident generation queue endpoints. */
 export const TASK_API = {
   submit: '/api/dsh-imagegen/tasks/submit',