dsh-image-gen 0.4.1 → 0.5.0

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

@@ -1,5 +1,5 @@
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
-import type { CloudImageProvider } from '../shared.js';
+import { type CloudImageProvider } from '../shared.js';
 /** One regenerated version displayed in place of an original conversation image. */
 export interface ConversationImageRevision {
     attachment: ImageAttachmentRef;

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

@@ -22,9 +22,12 @@ declare const DICT: {
         readonly tabTasks: "任务";
         readonly filterAllProviders: "全部提供商";
         readonly filterGoogle: "Google Gemini";
-        readonly filterOpenAI: "OpenAI / 中转站";
+        readonly filterOpenAI: "OpenAI";
+        readonly filterOpenAICompat: "OpenAI 兼容";
         readonly filterSeedream: "字节 Seedream";
         readonly filterDashScope: "阿里 DashScope";
+        readonly filterXAI: "xAI Grok";
+        readonly filterZhipu: "智谱 GLM";
         readonly filterComfyUI: "本地 ComfyUI";
         readonly filterAllModels: "全部模型";
         readonly filterAllRatios: "全部比例";
@@ -104,9 +107,12 @@ declare const DICT: {
         readonly tabTasks: "Tasks";
         readonly filterAllProviders: "All Providers";
         readonly filterGoogle: "Google Gemini";
-        readonly filterOpenAI: "OpenAI / Relay";
+        readonly filterOpenAI: "OpenAI";
+        readonly filterOpenAICompat: "OpenAI-compatible";
         readonly filterSeedream: "ByteDance Seedream";
         readonly filterDashScope: "Aliyun DashScope";
+        readonly filterXAI: "xAI Grok";
+        readonly filterZhipu: "Zhipu GLM";
         readonly filterComfyUI: "Local ComfyUI";
         readonly filterAllModels: "All Models";
         readonly filterAllRatios: "All Ratios";

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

@@ -19,10 +19,16 @@ interface ImageSettings {
     googleEndpoint?: string;
     openaiBaseURL?: string;
     openaiModel?: string;
+    openaiCompatBaseURL?: string;
+    openaiCompatModel?: string;
     seedreamBaseURL?: string;
     seedreamModel?: string;
     dashscopeEndpoint?: string;
     dashscopeModel?: string;
+    xaiBaseURL?: string;
+    xaiModel?: string;
+    zhipuBaseURL?: string;
+    zhipuModel?: string;
     comfyuiBaseURL?: string;
     comfyuiWorkflows?: ComfyUIWorkflowEntry[];
     comfyuiActiveWorkflow?: string;
@@ -31,9 +37,12 @@ interface ImageSettings {
     comfyuiTimeoutMs?: number;
     saveToWorkspace?: boolean;
     workspaceFolder?: string;
+    showProviderPill?: boolean;
 }
 interface CredentialInfo {
     configured?: boolean;
+    source?: string;
+    writable?: boolean;
 }
 interface CredentialResult {
     ok: boolean;
@@ -48,11 +57,18 @@ interface CredentialMutationResult {
 interface CredentialsRemote {
     describe(refs: string[]): Promise<CredentialResult>;
     set(ref: string, value: string): Promise<CredentialMutationResult>;
+    /** Present only on modern hosts; feature-detected before use. */
+    unset?(ref: string): Promise<CredentialMutationResult>;
+}
+/** Notifies the settings card whenever any credential reference changes on the host. */
+interface CredentialEvents {
+    listen(callback: () => void): () => void;
 }
 interface SettingsFace {
     scope: SettingsScope<ImageSettings>;
     credentials: CredentialsRemote;
     locale?: LocaleService | undefined;
+    credentialEvents?: CredentialEvents | undefined;
 }
 interface ImageCardFace {
     locale?: LocaleService | undefined;
@@ -72,7 +88,7 @@ interface ImageResultNodeProps {
 export declare const inject: string[];
 /** Mount the settings card, generated-image card, and native conversation gallery view. */
 export declare function apply(ctx: Context): void;
-/** Edit provider settings and its write-only API credential. */
+/** Edit each provider independently, pick an explicit default, and verify keys inline. */
 export declare function ImageGenerationSettingsCard(props: SettingsCardProps): import("react").JSX.Element;
 /** Keep the legacy Tool row for old DSH and hand modern results to the independent Chat node. */
 export declare function GeneratedImageCard(props: ImageCardProps): import("react").JSX.Element;

package/lib/types/client/inspiration-api.d.ts

@@ -0,0 +1,10 @@
+import type { InspirationCasesResponse } from '../inspiration/types.js';
+export declare function getInspirationImageUrl(sourceId: string, caseId: string): string;
+export declare function fetchInspirationCases(): Promise<InspirationCasesResponse | null>;
+export interface UpdateResponse {
+    updated: boolean;
+    currentCount: number;
+    newCount?: number;
+    message: string;
+}
+export declare function triggerInspirationUpdate(): Promise<UpdateResponse | null>;

package/lib/types/client/inspiration-detail.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Modal detail view for a specific Inspiration Library case.
+ */
+import { type FC } from 'react';
+import type { PromptCase, PromptSource } from '../inspiration/types.js';
+export interface InspirationDetailProps {
+    promptCase: PromptCase;
+    source: PromptSource;
+    lang?: 'zh' | 'en';
+    onClose: () => void;
+    onUsePrompt: (prompt: string) => void;
+    onToast: (msg: string) => void;
+}
+export declare const InspirationDetail: FC<InspirationDetailProps>;

package/lib/types/client/provider-pill.d.ts

@@ -0,0 +1,49 @@
+import { type ComfyUIWorkflowEntry, type ImageProvider } from '../shared.js';
+import type { SettingsScope } from './index.js';
+import type { LocaleService } from './gallery-view.js';
+/** Settings fields the pill reads; a structural subset of the full settings shape. */
+export interface PillSettings {
+    provider?: ImageProvider;
+    googleModel?: string;
+    openaiModel?: string;
+    openaiCompatModel?: string;
+    seedreamModel?: string;
+    dashscopeModel?: string;
+    xaiModel?: string;
+    zhipuModel?: string;
+    comfyuiWorkflows?: readonly ComfyUIWorkflowEntry[];
+    comfyuiActiveWorkflow?: string;
+    comfyuiWorkflowJson?: string;
+    comfyuiWorkflowName?: string;
+    /** Opt-in toggle persisted by the settings card; the pill stays hidden until enabled. */
+    showProviderPill?: boolean;
+}
+/** Minimal credential face the pill needs; structurally satisfied by the settings card's remote. */
+interface PillCredentials {
+    describe(refs: string[]): Promise<{
+        ok: boolean;
+        value?: Readonly<Record<string, {
+            configured?: boolean;
+        }>>;
+    }>;
+}
+/** Notifies the pill whenever any credential reference changes on the host. */
+interface PillCredentialEvents {
+    listen(callback: () => void): () => void;
+}
+/** Business face injected at registration time by the client entry. */
+export interface ProviderPillFace {
+    scope: SettingsScope<PillSettings>;
+    credentials: PillCredentials;
+    locale?: LocaleService | undefined;
+    credentialEvents?: PillCredentialEvents | undefined;
+}
+/** Whether the user opted into the composer pill; hidden (not merely inert) when off. */
+export declare function pillVisible(value: PillSettings | undefined): boolean;
+/** Model (or ComfyUI workflow) a provider row will use with the persisted settings. */
+export declare function pillModelOf(provider: ImageProvider, value: PillSettings | undefined): string;
+/** One fixed-position provider menu anchored to the pill button. */
+export declare function ImageProviderPill(props: ProviderPillFace): import("react").JSX.Element | null;
+/** Styles for the pill and its fixed-position menu; injected by the client entry. */
+export declare const PROVIDER_PILL_STYLE = "\n.dsh-ig-pill-root{position:relative;display:inline-flex;align-items:center;height:26px}\n.dsh-ig-pill-button{display:inline-flex;align-items:center;gap:5px;height:26px;padding:0 8px 0 7px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:13px;background:var(--dsw-alias-bg-layer-3,#fff);color:var(--dsw-alias-label-secondary,#4b5563);font:inherit;font-size:12px;line-height:1;cursor:pointer;transition:border-color .15s,background .15s,color .15s;-webkit-user-select:none;user-select:none}\n.dsh-ig-pill-button:hover:not(:disabled){border-color:var(--dsw-alias-label-dimmed,#9ca3af);color:var(--dsw-alias-label-primary,#111827)}\n.dsh-ig-pill-button:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4c78ff);outline-offset:1px}\n.dsh-ig-pill-button:disabled{opacity:.5;cursor:not-allowed}\n.dsh-ig-pill-button-open{border-color:var(--dsw-alias-brand-primary,#4c78ff);color:var(--dsw-alias-label-primary,#111827)}\n.dsh-ig-pill-icon{flex:none;color:var(--dsw-alias-brand-primary,#4c78ff)}\n.dsh-ig-pill-provider{max-width:96px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.dsh-ig-pill-caret{display:inline-flex;flex:none;transition:transform .15s}\n.dsh-ig-pill-caret-open{transform:rotate(180deg)}\n.dsh-ig-pill-menu{position:fixed;z-index:1000;min-width:264px;max-width:min(320px,calc(100vw - 24px));padding:6px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:12px;background:var(--dsw-alias-bg-layer-3,#fff);box-shadow:0 12px 32px rgba(0,0,0,.16),0 2px 8px rgba(0,0,0,.08);max-height:min(320px,calc(100vh - 48px));overflow-y:auto}\n.dsh-ig-pill-menu-title{padding:6px 8px 4px;font-size:11px;font-weight:600;color:var(--dsw-alias-label-tertiary,#6b7280)}\n.dsh-ig-pill-option{display:flex;width:100%;align-items:center;gap:9px;padding:7px 8px;border:0;border-radius:8px;background:none;font:inherit;color:inherit;text-align:left;cursor:pointer}\n.dsh-ig-pill-option:hover:not(:disabled){background:var(--dsw-alias-bg-layer-2,#f3f4f6)}\n.dsh-ig-pill-option:disabled{opacity:.6;cursor:default}\n.dsh-ig-pill-option:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4c78ff);outline-offset:-2px}\n.dsh-ig-pill-option-active{background:var(--dsw-alias-brand-primary-soft,rgba(76,120,255,.10))}\n.dsh-ig-pill-dot{flex:none;width:7px;height:7px;border-radius:50%}\n.dsh-ig-pill-dot-ok{background:#22c55e}\n.dsh-ig-pill-dot-missing{background:var(--dsw-alias-border-l2,#d1d5db)}\n.dsh-ig-pill-dot-neutral{background:var(--dsw-alias-brand-primary,#4c78ff)}\n.dsh-ig-pill-option-text{flex:1;min-width:0;display:flex;flex-direction:column;gap:2px}\n.dsh-ig-pill-option-name{font-size:12.5px;font-weight:500;color:var(--dsw-alias-label-primary,#111827);line-height:1.2}\n.dsh-ig-pill-option-sub{font-size:11px;color:var(--dsw-alias-label-tertiary,#6b7280);line-height:1.2;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}\n.dsh-ig-pill-check{flex:none;color:var(--dsw-alias-brand-primary,#4c78ff)}\n.dsh-ig-pill-error{margin-top:4px;padding:6px 8px;border-radius:8px;background:rgba(239,68,68,.08);color:#ef4444;font-size:11.5px;line-height:1.4;word-break:break-all}\n";
+export {};

package/lib/types/config.d.ts

@@ -1,17 +1,9 @@
 /** 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, 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, };
+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, DEFAULT_XAI_BASE_URL, DEFAULT_XAI_MODEL, DEFAULT_ZHIPU_BASE_URL, DEFAULT_ZHIPU_MODEL, DASHSCOPE_API_KEY_ENV, GOOGLE_API_KEY_ENV, IMAGE_PROVIDERS, OPENAI_API_KEY_ENV, OPENAI_COMPAT_API_KEY_ENV, SEEDREAM_API_KEY_ENV, XAI_API_KEY_ENV, ZHIPU_API_KEY_ENV, 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, DEFAULT_XAI_BASE_URL, DEFAULT_XAI_MODEL, DEFAULT_ZHIPU_BASE_URL, DEFAULT_ZHIPU_MODEL, DASHSCOPE_API_KEY_ENV, GOOGLE_API_KEY_ENV, IMAGE_PROVIDERS, OPENAI_API_KEY_ENV, OPENAI_COMPAT_API_KEY_ENV, SEEDREAM_API_KEY_ENV, XAI_API_KEY_ENV, ZHIPU_API_KEY_ENV, 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. */
-export declare const GOOGLE_API_KEY_ENV = "GEMINI_API_KEY";
-/** OpenAI Platform or compatible relay credential reference. */
-export declare const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
-/** Volcengine Ark credential reference. */
-export declare const SEEDREAM_API_KEY_ENV = "ARK_API_KEY";
-/** DashScope credential reference. */
-export declare const DASHSCOPE_API_KEY_ENV = "DASHSCOPE_API_KEY";
 /** Google tool-level controls. */
 export declare const ASPECT_RATIOS: readonly ["1:1", "3:2", "2:3", "4:3", "3:4", "16:9", "9:16"];
 export declare const IMAGE_SIZES: readonly ["1K", "2K", "4K"];
@@ -24,10 +16,17 @@ export interface Config {
     googleEndpoint?: string;
     openaiBaseURL?: string;
     openaiModel?: string;
+    /** OpenAI-compatible relay settings; independent from the official OpenAI row. */
+    openaiCompatBaseURL?: string;
+    openaiCompatModel?: string;
     seedreamBaseURL?: string;
     seedreamModel?: string;
     dashscopeEndpoint?: string;
     dashscopeModel?: string;
+    xaiBaseURL?: string;
+    xaiModel?: string;
+    zhipuBaseURL?: string;
+    zhipuModel?: string;
     comfyuiBaseURL?: string;
     /** Named ComfyUI workflows managed by the Web settings page. */
     comfyuiWorkflows?: ComfyUIWorkflowEntry[];
@@ -59,6 +58,12 @@ export declare function resolveProvider(config: Config): {
     model: string;
     baseURL: string;
     imageSize: string;
+} | {
+    provider: 'openai-compat';
+    apiKeyEnv: string;
+    model: string;
+    baseURL: string;
+    imageSize: string;
 } | {
     provider: 'seedream';
     apiKeyEnv: string;
@@ -71,6 +76,18 @@ export declare function resolveProvider(config: Config): {
     model: string;
     endpoint: string;
     imageSize: string;
+} | {
+    provider: 'xai';
+    apiKeyEnv: string;
+    model: string;
+    baseURL: string;
+    imageSize: string;
+} | {
+    provider: 'zhipu';
+    apiKeyEnv: string;
+    model: string;
+    baseURL: string;
+    imageSize: string;
 } | {
     provider: 'comfyui';
     baseURL: string;
@@ -78,6 +95,18 @@ export declare function resolveProvider(config: Config): {
     workflow?: ComfyUIWorkflowEntry;
     timeoutMs: number;
 };
+/**
+ * Apply a per-call provider and/or model override on top of the saved config.
+ * `model` is ignored for ComfyUI, whose per-call equivalent is `workflow`.
+ */
+export declare function withProviderOverrides(config: Config, provider?: ImageProvider, model?: string): Config;
+/**
+ * One-time migration: when the legacy single OpenAI slot points at a relay
+ * (non-official base URL) and the compat row is empty, move the relay config
+ * to the compat row so both can coexist. Returns the input untouched when
+ * nothing needs moving.
+ */
+export declare function migrateOpenAICompatConfig(config: Config): Config;
 /** The workflow a ComfyUI call runs: the requested name when given, else the active one. */
 export declare function selectComfyUIWorkflow(active: {
     workflows: ComfyUIWorkflowEntry[];

package/lib/types/credentials.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { type CloudImageProvider } from './shared.js';
+/**
+ * Resolve one provider's stored API key to a non-blank value. Blank values
+ * never count as configured: the host treats an empty stored value as absent,
+ * and a whitespace-only key is never sent to a provider.
+ */
+export declare function resolveApiKey(ctx: Context, provider: CloudImageProvider): Promise<string | undefined>;
+/**
+ * Resolve one provider's API key or fail with a user-facing message that says
+ * where to configure it. Passing `tool` selects the Agent-facing English
+ * wording; without it the message is the browser-facing Chinese one used by
+ * the Studio route.
+ */
+export declare function requireApiKey(ctx: Context, provider: CloudImageProvider, tool?: string): Promise<string>;

package/lib/types/index.d.ts

@@ -5,6 +5,7 @@ export { Config } from './config.js';
 export { IMAGE_ROUTE, DELETE_ROUTE, SAVE_WORKSPACE_ROUTE, imageAttachmentFromMeta } from './image-route.js';
 export { STUDIO_ROUTE } from './shared.js';
 export { INSPIRATION_ROUTE } from './shared.js';
+export { TEST_CONNECTION_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/inspiration/cache.d.ts

@@ -0,0 +1,20 @@
+export declare const DEFAULT_MAX_CACHE_BYTES: number;
+export declare function setInspirationCacheDir(dir: string): void;
+export declare function getInspirationCacheDir(): string;
+export declare function cacheKey(sourceId: string, caseId: string): string;
+export interface CachedImageMetadata {
+    contentType: string;
+    sourceId: string;
+    caseId: string;
+    savedAt: number;
+}
+export declare function getCachedImagePath(key: string): string | null;
+export declare function readCachedImage(key: string): {
+    data: Buffer;
+    contentType: string;
+} | null;
+export declare function writeCachedImage(key: string, data: Buffer, contentType: string, sourceId: string, caseId: string, maxBytes?: number): void;
+/**
+ * Enforce max cache size constraint by evicting oldest accessed files.
+ */
+export declare function evictCacheIfNeeded(maxBytes?: number): void;

package/lib/types/inspiration/downloader.d.ts

@@ -0,0 +1,27 @@
+import type { PromptCase, PromptSource } from './types.js';
+export declare const MAX_IMAGE_BYTES: number;
+export declare const FETCH_TIMEOUT_MS = 6000;
+/**
+ * Validate that an IP or hostname is not private/loopback (SSRF protection).
+ */
+export declare function isPrivateOrLocalAddress(hostname: string): boolean;
+/**
+ * Check binary magic bytes to verify genuine image type.
+ * Rejects SVGs, HTML, scripts, executables.
+ */
+export declare function sniffImageMimeType(buf: Buffer): 'image/jpeg' | 'image/png' | 'image/webp' | null;
+/**
+ * Safely fetch a single URL with strict checks.
+ */
+export declare function fetchSingleImageUrl(urlStr: string, allowedDomains: string[]): Promise<{
+    data: Buffer;
+    contentType: string;
+} | null>;
+/**
+ * Multi-tier racing / fallback fetcher:
+ * Tries candidate URLs in order until a valid image is retrieved.
+ */
+export declare function fetchInspirationImage(source: PromptSource, promptCase: PromptCase): Promise<{
+    data: Buffer;
+    contentType: string;
+} | null>;

package/lib/types/inspiration/routes.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Server-side route handlers for the Inspiration Library.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+export declare function serveInspirationCases(_req: IncomingMessage, res: ServerResponse): Promise<void>;
+/**
+ * Handle GET /plugins/dsh-image-gen/inspiration/image/:sourceId/:caseId
+ */
+export declare function serveInspirationImage(req: IncomingMessage, res: ServerResponse): Promise<void>;
+/**
+ * Handle POST /plugins/dsh-image-gen/inspiration/update
+ */
+export declare function serveInspirationUpdate(req: IncomingMessage, res: ServerResponse): Promise<void>;

package/lib/types/inspiration/sources.d.ts

@@ -0,0 +1,33 @@
+import type { PromptCase, PromptSource } from './types.js';
+/**
+ * Find the path to the inspiration snapshots folder.
+ * Supports both development (src/) and built distribution (root / lib).
+ */
+export declare function getSnapshotsDir(): string;
+/**
+ * Load built-in prompt sources from packaged JSON snapshots.
+ */
+export declare function loadBuiltinSources(): PromptSource[];
+/**
+ * Clear cached sources to allow reloading upon update.
+ */
+export declare function invalidateSourcesCache(): void;
+/**
+ * Get a specific prompt source by ID.
+ */
+export declare function getPromptSource(sourceId: string): PromptSource | undefined;
+/**
+ * Find a specific case within a source.
+ */
+export declare function getPromptCase(sourceId: string, caseId: string): {
+    source: PromptSource;
+    promptCase: PromptCase;
+} | undefined;
+/**
+ * Resolve candidate URLs for downloading an inspiration case's image.
+ * Uses a prioritized multi-tier fallback:
+ * 1. Fast, reliable global CDN (fastly.jsdelivr.net) - free, doesn't load author's server
+ * 2. Canghe.ai official website static origin (fast in mainland China)
+ * 3. GitHub raw official fallback
+ */
+export declare function resolveCaseImageCandidateUrls(source: PromptSource, promptCase: PromptCase): string[];

package/lib/types/inspiration/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Type definitions and contracts for the Prompt Library / Inspiration system.
+ */
+export interface PromptCase {
+    /** Unique case ID within the source (e.g. "544" or "case-544") */
+    id: string;
+    /** Human-readable title */
+    title: string;
+    /** The full prompt text to be reused */
+    prompt: string;
+    /** Image identifier or path (e.g. "/images/case544.jpg" or "case544.jpg") */
+    image?: string | undefined;
+    /** Primary category (e.g. "UI & Interfaces", "Products & E-commerce") */
+    category?: string | undefined;
+    /** Visual styles (e.g. ["UI", "Poster", "Realistic"]) */
+    styles?: string[] | undefined;
+    /** Application scenarios (e.g. ["Tech", "Commerce"]) */
+    scenes?: string[] | undefined;
+    /** Original creator or source platform display name */
+    sourceLabel?: string | undefined;
+    /** Link to original social post or source article */
+    sourceUrl?: string | undefined;
+    /** Original author name if known */
+    author?: string | undefined;
+    /** Author homepage or profile */
+    authorUrl?: string | undefined;
+    /** License name if explicitly declared */
+    license?: string | undefined;
+    /** License URL if explicitly declared */
+    licenseUrl?: string | undefined;
+    /** Recommended model hint if available */
+    modelHint?: string | undefined;
+    /** Whether the case is marked as featured / staff pick */
+    featured?: boolean | undefined;
+    /** Direct link back to upstream repository documentation */
+    githubUrl?: string | undefined;
+}
+export interface PromptSource {
+    id: string;
+    name: string;
+    homepage?: string | undefined;
+    version: string;
+    schemaVersion: number;
+    /** Domain whitelist allowed for fetching images for this source */
+    allowedDomains: string[];
+    /** Array of prompt cases */
+    cases: PromptCase[];
+    /** Available categories extracted from cases */
+    categories?: string[] | undefined;
+    /** Available styles extracted from cases */
+    styles?: string[] | undefined;
+    /** Available scenes extracted from cases */
+    scenes?: string[] | undefined;
+}
+export interface InspirationManifest {
+    schemaVersion: number;
+    sourceVersion: string;
+    updatedAt: string;
+    sha256: string;
+    totalCases: number;
+}
+export interface InspirationCasesResponse {
+    sources: PromptSource[];
+    activeSourceId: string;
+}

package/lib/types/inspiration/updater.d.ts

@@ -0,0 +1,7 @@
+export interface UpdateCheckResult {
+    updated: boolean;
+    currentCount: number;
+    newCount?: number;
+    message: string;
+}
+export declare function checkAndApplyInspirationUpdate(): Promise<UpdateCheckResult>;

package/lib/types/openai-compatible.d.ts

@@ -9,7 +9,7 @@ export interface CompatibleReferenceImage {
     mediaType: ImageMediaType;
 }
 export declare function generateOpenAICompatibleImage(input: {
-    provider: 'openai' | 'seedream';
+    provider: 'openai' | 'openai-compat' | 'seedream' | 'xai' | 'zhipu';
     apiKey: string;
     baseURL: string;
     model: string;

package/lib/types/redact.d.ts

@@ -0,0 +1,2 @@
+/** Replace every occurrence of a known secret plus key-shaped values. */
+export declare function redactSecrets(text: string, ...secrets: Array<string | undefined>): string;

package/lib/types/shared.d.ts

@@ -10,14 +10,45 @@ export declare const STUDIO_ROUTE = "/plugins/dsh-image-gen/studio";
 export declare const INSPIRATION_ROUTE = "/plugins/dsh-image-gen/inspiration";
 /** Browser route used for saving generated images to workspace on demand. */
 export declare const SAVE_WORKSPACE_ROUTE = "/plugins/dsh-image-gen/save-workspace";
+/** Browser route the settings card probes provider connectivity through. */
+export declare const TEST_CONNECTION_ROUTE = "/plugins/dsh-image-gen/test";
 /** 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 declare const IMAGE_PROVIDERS: readonly ["google", "openai", "openai-compat", "seedream", "dashscope", "xai", "zhipu", "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 declare const CLOUD_IMAGE_PROVIDERS: readonly ["google", "openai", "openai-compat", "seedream", "dashscope", "xai", "zhipu"];
 export type CloudImageProvider = typeof CLOUD_IMAGE_PROVIDERS[number];
+/**
+ * Credential references resolved through the DSH Credentials service (BYOK).
+ * These are POSIX-style reference names, not environment variables: the host
+ * layers the process environment and its managed store behind them, so a name
+ * like OPENAI_API_KEY is shared with any other plugin resolving the same ref.
+ */
+export declare const GOOGLE_API_KEY_ENV = "GEMINI_API_KEY";
+/** OpenAI Platform credential reference. */
+export declare const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
+/**
+ * OpenAI-compatible relay credential reference. Deliberately distinct from
+ * OPENAI_API_KEY so an official key and a relay key can coexist without
+ * overwriting each other.
+ */
+export declare const OPENAI_COMPAT_API_KEY_ENV = "DSH_IMAGE_GEN_OPENAI_COMPAT_KEY";
+/** Volcengine Ark credential reference. */
+export declare const SEEDREAM_API_KEY_ENV = "ARK_API_KEY";
+/** DashScope credential reference. */
+export declare const DASHSCOPE_API_KEY_ENV = "DASHSCOPE_API_KEY";
+/** xAI credential reference; matches the official xAI SDK environment name. */
+export declare const XAI_API_KEY_ENV = "XAI_API_KEY";
+/** Zhipu credential reference; matches the official Zhipu SDK environment name. */
+export declare const ZHIPU_API_KEY_ENV = "ZHIPUAI_API_KEY";
+/** The credential reference each cloud provider's API key is stored under. */
+export declare const CLOUD_CREDENTIAL_REFS: Record<CloudImageProvider, string>;
+/** The credential reference storing this provider's API key, when it uses one. */
+export declare function cloudCredentialRef(provider: ImageProvider): string | undefined;
+/** Locale-neutral provider names for user-facing errors and status lines. */
+export declare const PROVIDER_DISPLAY_NAMES: Record<ImageProvider, string>;
 /** One selectable output option exposed by a provider profile. */
 export interface StudioOption {
     value: string;
@@ -99,6 +130,8 @@ export declare const DEFAULT_GOOGLE_ENDPOINT = "https://generativelanguage.googl
 export declare const DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1";
 export declare const DEFAULT_SEEDREAM_BASE_URL = "https://ark.cn-beijing.volces.com/api/v3";
 export declare const DEFAULT_DASHSCOPE_ENDPOINT = "https://dashscope.aliyuncs.com/api/v1";
+export declare const DEFAULT_XAI_BASE_URL = "https://api.x.ai/v1";
+export declare const DEFAULT_ZHIPU_BASE_URL = "https://open.bigmodel.cn/api/paas/v4";
 export declare const DEFAULT_COMFYUI_BASE_URL = "http://127.0.0.1:8188";
 export declare const DEFAULT_COMFYUI_TIMEOUT_MS = 300000;
 export declare const DEFAULT_COMFYUI_WORKFLOW_LABEL = "API workflow";
@@ -108,6 +141,8 @@ 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";
+export declare const DEFAULT_XAI_MODEL = "grok-imagine-image";
+export declare const DEFAULT_ZHIPU_MODEL = "glm-image";
 /** 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. */

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

@@ -0,0 +1,73 @@
+/** Same-origin connection probe the settings card runs per provider. */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Config, ImageProvider } from './config.js';
+import { type CloudImageProvider } from './shared.js';
+export { TEST_CONNECTION_ROUTE } from './shared.js';
+/** One probe target a provider resolves to: a URL plus its auth headers. */
+export interface ProbeTarget {
+    url: string;
+    headers: Record<string, string>;
+}
+/**
+ * The endpoint each provider is probed on. All four cloud providers expose a
+ * model-list GET that authenticates with the same credential image generation
+ * uses; ComfyUI exposes its standard `system_stats` health endpoint.
+ */
+export declare function probeTarget(provider: ImageProvider, config: Config, apiKey?: string | undefined): ProbeTarget;
+/** Structured probe outcome the settings card maps onto localized text. */
+export type ProbeResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'missing-key' | 'unauthorized' | 'error';
+    message?: string;
+};
+/** Model-pull outcome: a filtered list of image-capable model ids on success. */
+export type ModelsResult = {
+    ok: true;
+    models: string[];
+} | {
+    ok: false;
+    reason: 'missing-key' | 'unauthorized' | 'error';
+    message?: string;
+};
+/** Extract bare model ids from a Google `list models` payload (`models/{id}`). */
+export declare function parseGoogleModelIds(payload: unknown): string[];
+/** Heuristic filter: Gemini image models carry `image`/`imagen` in the id. */
+export declare function filterImageModelIds(ids: readonly string[]): string[];
+/** Narrow filter for the official OpenAI catalog: gpt-image and DALL·E families. */
+export declare function filterOpenAIImageModelIds(ids: readonly string[]): string[];
+/** Broad filter for relays: common image-model id fragments across vendors. */
+export declare function filterRelayImageModelIds(ids: readonly string[]): string[];
+/** Ark catalog filter: the Seedream (generation) and SeedEdit (editing) families. */
+export declare function filterSeedreamImageModelIds(ids: readonly string[]): string[];
+/** Zhipu catalog filter: GLM-Image and CogView families. */
+export declare function filterZhipuImageModelIds(ids: readonly string[]): string[];
+/** Extract model ids from an OpenAI-style `{data:[{id}]}` or xAI-style `{models:[{id}]}` payload. */
+export declare function parseOpenAIModelIds(payload: unknown): string[];
+/**
+ * Extract image-capable model ids from a DashScope native
+ * `{output:{models:[{model,capabilities}]}}` payload. The `capabilities`
+ * array marks image generation as `IG`; name fragments are a fallback for
+ * payloads that omit the field.
+ */
+export declare function parseDashScopeImageModelIds(payload: unknown): string[];
+/** Pull and filter the image-capable models from the Google endpoint. */
+export declare function fetchGoogleImageModels(config: Config, apiKey: string | undefined, signal?: AbortSignal | undefined): Promise<ModelsResult>;
+/** Pull and filter image-capable models from an OpenAI-compatible endpoint (official, relay, Ark, xAI, Zhipu). */
+export declare function fetchOpenAIImageModels(provider: 'openai' | 'openai-compat' | 'seedream' | 'xai' | 'zhipu', config: Config, apiKey: string | undefined, signal?: AbortSignal | undefined): Promise<ModelsResult>;
+/** Pull and filter image-capable models from the DashScope native model list (`capabilities=IG`). */
+export declare function fetchDashScopeImageModels(config: Config, apiKey: string | undefined, signal?: AbortSignal | undefined): Promise<ModelsResult>;
+/** Run one provider probe and classify the outcome; secrets never leave redacted. */
+export declare function probeProviderConnection(provider: CloudImageProvider, config: Config, apiKey: string | undefined, signal?: AbortSignal | undefined): Promise<ProbeResult>;
+/** Probe the local ComfyUI service without any credential. */
+export declare function probeComfyUIConnection(config: Config, signal?: AbortSignal | undefined): Promise<ProbeResult>;
+/** Dependencies the test route needs from the plugin entry. */
+export interface TestRouteDeps {
+    /** The credential each cloud provider probes with, when one is stored. */
+    resolveKey(provider: CloudImageProvider): Promise<string | undefined>;
+    /** The currently authoritative config, including unsaved defaults. */
+    config(): Config;
+}
+/** Serve the settings card's per-provider connectivity probe. */
+export declare function serveTestConnection(req: IncomingMessage, res: ServerResponse, deps: TestRouteDeps): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-image-gen",
-  "version": "0.4.1",
+  "version": "0.5.0",
   "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope, local ComfyUI & more.",
   "type": "module",
   "author": "shanliuling",