dsh-image-gen 0.9.2 → 0.10.0

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

@@ -5,6 +5,7 @@ export interface ConversationImageRevision {
     attachment: ImageAttachmentRef;
     prompt: string;
     provider: StudioProvider;
+    channel?: string;
     model: string;
     output: string;
     createdAt: number;

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

@@ -1,6 +1,7 @@
 import { type StudioGenerateRequest, type StudioWatermark } from '../shared.js';
 export interface RegeneratableImage {
     provider: string;
+    channel?: string | undefined;
     model: string;
     output?: string | undefined;
 }

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

@@ -11,6 +11,7 @@ export interface GalleryItem {
     prompt: string;
     /** Generation provider, or 'import' for user-uploaded images. */
     provider: ImageProvider | 'import';
+    channel?: string | undefined;
     model: string;
     createdAt: number;
     aspectRatio?: string | undefined;

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

@@ -5,6 +5,7 @@ export interface ImageResultPresentation {
     readonly attachment: ImageAttachmentRef;
     readonly prompt: string;
     readonly provider: string;
+    readonly channel?: string;
     readonly model: string;
     readonly output: string;
     readonly savedTo?: string;

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

@@ -9,27 +9,33 @@ export interface SettingsScope<T> {
     set(field: string, value: unknown): Promise<boolean | void>;
 }
 import type { InjectFace, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
-import { type ComfyUIWorkflowEntry, type ImageProvider } from '../shared.js';
+import { type ComfyUIWorkflowEntry, type OpenAICompatChannel, type ImageProvider } from '../shared.js';
 import { type LocaleService } from './gallery-view.js';
 import { type ImageResultPresentation } from './image-result-node.js';
 type Provider = ImageProvider;
 interface ImageSettings {
     provider?: Provider;
+    cloudTimeoutMs?: number;
     googleModel?: string;
     googleEndpoint?: string;
     googleNative?: boolean;
     openaiBaseURL?: string;
     openaiModel?: string;
     openaiSizes?: Record<string, Record<string, string>>;
+    openaiCompatLabel?: string;
     openaiCompatBaseURL?: string;
     openaiCompatModel?: string;
+    openaiCompatModels?: string[];
+    openaiCompatChannels?: OpenAICompatChannel[];
+    openaiCompatActiveChannel?: string;
+    openaiCompatEditModel?: string;
     openaiCompatSizes?: Record<string, Record<string, string>>;
     openaiCompatQuality?: string;
     openaiCompatQualityOptions?: string[];
     openaiCompatExtraBody?: Record<string, unknown>;
     openaiCompatEditSizeMode?: 'auto' | 'selected';
     /** Edit-request shape for the openai-compat relay (#41); see src/config.ts. */
-    openaiCompatEditFormat?: 'multipart' | 'jsonImageUrlArray' | 'formReferenceImages';
+    openaiCompatEditFormat?: 'multipart' | 'jsonImageUrlArray' | 'formReferenceImages' | 'siliconflowJson';
     /** Extra JSON fields merged into the JSON edit body; ignored in multipart mode. */
     openaiCompatEditExtra?: Record<string, unknown>;
     seedreamBaseURL?: string;

package/lib/types/client/multi-model-compare.d.ts

@@ -1,4 +1,4 @@
-import type { StudioOption, StudioProvider, StudioProviderProfile } from '../shared.js';
+import { type StudioOption, type StudioProvider, type StudioProviderProfile } from '../shared.js';
 export interface ComparisonTarget {
     profile: StudioProviderProfile;
     ratio: string;
@@ -8,13 +8,13 @@ export interface ComparisonTarget {
     generationQuality?: string;
 }
 /** Map one shared output intent to settings accepted by every target model. */
-export declare function buildComparisonTargets(profiles: readonly StudioProviderProfile[], selectedProviders: readonly StudioProvider[], ratio: string, quality: string, output?: {
+export declare function buildComparisonTargets(profiles: readonly StudioProviderProfile[], selectedTargets: readonly string[], ratio: string, quality: string, output?: {
     resolution: string;
     generationQuality: string;
 }): ComparisonTarget[];
 /** Keep pixel tiers separate from upstream quality values in comparison mode. */
 export declare function comparisonOutputOptions(profiles: readonly StudioProviderProfile[], ratio: string, kind: 'resolution' | 'generationQuality'): StudioOption[];
 /** Start with two models, not every configured API, to avoid surprise spend. */
-export declare function initialComparisonProviders(profiles: readonly StudioProviderProfile[], activeProvider: StudioProvider): StudioProvider[];
+export declare function initialComparisonProviders(profiles: readonly StudioProviderProfile[], activeProvider: StudioProvider, activeChannel?: string): string[];
 /** Union of every configured profile's options, for the shared comparison pickers. */
 export declare function comparisonOptionUnion(profiles: readonly StudioProviderProfile[], key: 'ratioOptions' | 'qualityOptions'): StudioOption[];

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

@@ -1,4 +1,4 @@
-import { type ComfyUIWorkflowEntry, type ImageProvider } from '../shared.js';
+import { type ComfyUIWorkflowEntry, type OpenAICompatChannel, 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. */
@@ -6,7 +6,11 @@ export interface PillSettings {
     provider?: ImageProvider;
     googleModel?: string;
     openaiModel?: string;
+    openaiCompatLabel?: string;
     openaiCompatModel?: string;
+    openaiCompatModels?: readonly string[];
+    openaiCompatChannels?: readonly OpenAICompatChannel[];
+    openaiCompatActiveChannel?: string;
     seedreamModel?: string;
     dashscopeModel?: string;
     xaiModel?: string;
@@ -41,9 +45,11 @@ export interface ProviderPillFace {
 /** 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;
+export declare function pillModelOf(provider: ImageProvider, value: PillSettings | undefined, channelId?: string): string;
+/** Optional model choices exposed by a provider; single-model providers return an empty list. */
+export declare function pillModelOptionsOf(provider: ImageProvider, value: PillSettings | undefined, channelId?: string): 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:28px}\n.dsh-ig-pill-button{display:inline-flex;align-items:center;gap:5px;height:28px;padding:0 9px 0 8px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:14px;background:var(--dsw-alias-bg-layer-3,#fff);color:var(--dsw-alias-label-secondary,#4b5563);font:inherit;font-size:13px;line-height:20px;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:150px;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@container (max-width:700px){\n  .dsh-ig-pill-caret{display:none}\n  .dsh-ig-pill-button{padding:0 7px 0 6px}\n}\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:#9ca3af}\n.dsh-ig-pill-dot-neutral{background:#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 declare const PROVIDER_PILL_STYLE = "\n.dsh-ig-pill-root{position:relative;display:inline-flex;align-items:center;height:28px}\n.dsh-ig-pill-button{display:inline-flex;align-items:center;gap:5px;height:28px;padding:0 9px 0 8px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:14px;background:var(--dsw-alias-bg-layer-3,#fff);color:var(--dsw-alias-label-secondary,#4b5563);font:inherit;font-size:13px;line-height:20px;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:150px;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@container (max-width:700px){\n  .dsh-ig-pill-caret{display:none}\n  .dsh-ig-pill-button{padding:0 7px 0 6px}\n}\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:#9ca3af}\n.dsh-ig-pill-dot-neutral{background:#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-model-option{padding-left:24px}\n.dsh-ig-pill-model-name{flex:1;min-width:0;font-size:12px;color:var(--dsw-alias-label-secondary,#4b5563);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,8 +1,8 @@
 /** User-facing configuration for supported image providers. */
 import z from '@deepseek-ai/schemastery';
 import type { CompatEditFormat } from './openai-compatible.js';
-import { ARK_BACKGROUND_MODES, ARK_OUTPUT_FORMATS, 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 ArkBackgroundMode, type ArkOutputFormat, type ArkOutputOptions, type ComfyUIWorkflowEntry, type ImageProvider } from './shared.js';
-export { ARK_BACKGROUND_MODES, ARK_OUTPUT_FORMATS, 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 ArkBackgroundMode, type ArkOutputFormat, type ArkOutputOptions, type ComfyUIWorkflowEntry, type ImageProvider, };
+import { ARK_BACKGROUND_MODES, ARK_OUTPUT_FORMATS, DEFAULT_CLOUD_TIMEOUT_MS, 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 OpenAICompatChannel, type ArkBackgroundMode, type ArkOutputFormat, type ArkOutputOptions, type ComfyUIWorkflowEntry, type ImageProvider } from './shared.js';
+export { ARK_BACKGROUND_MODES, ARK_OUTPUT_FORMATS, DEFAULT_CLOUD_TIMEOUT_MS, 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 ArkBackgroundMode, type ArkOutputFormat, type ArkOutputOptions, type ComfyUIWorkflowEntry, type ImageProvider, };
 /** Default workspace subfolder that receives generated image files. */
 export declare const DEFAULT_WORKSPACE_FOLDER = "dsh-image-gen";
 /** Google tool-level controls. Aligned with gemini-3.1-flash-image's common set. */
@@ -13,6 +13,7 @@ export type ImageSize = typeof IMAGE_SIZES[number];
 /** Bundle configuration from the profile patch and the Web settings page. */
 export interface Config {
     provider?: ImageProvider;
+    cloudTimeoutMs?: number;
     googleModel?: string;
     googleEndpoint?: string;
     /** Use Gemini generateContent instead of Interactions; opt-in for native-only gateways. */
@@ -22,8 +23,16 @@ export interface Config {
     /** Official model size table: ratio -> resolution tier -> pixels. Empty uses model presets. */
     openaiSizes?: Record<string, Record<string, string>>;
     /** OpenAI-compatible relay settings; independent from the official OpenAI row. */
+    openaiCompatLabel?: string;
     openaiCompatBaseURL?: string;
     openaiCompatModel?: string;
+    /** Models offered by the workbench for the legacy default channel. */
+    openaiCompatModels?: string[];
+    /** Additional named relay channels; the flat fields above remain the default channel. */
+    openaiCompatChannels?: OpenAICompatChannel[];
+    openaiCompatActiveChannel?: string;
+    /** Editing model; empty reuses the generation model. */
+    openaiCompatEditModel?: string;
     /** Default quality; empty preserves the upstream default by omitting the field. */
     openaiCompatQuality?: string;
     /** Quality values accepted by this relay; independent of resolution tiers. */
@@ -40,7 +49,7 @@ export interface Config {
       * `reference_images` field is a JSON array of base64 strings. Defaults to
       * `multipart`.
       */
-    openaiCompatEditFormat?: 'multipart' | 'jsonImageUrlArray' | 'formReferenceImages';
+    openaiCompatEditFormat?: 'multipart' | 'jsonImageUrlArray' | 'formReferenceImages' | 'siliconflowJson';
     /**
      * Extra JSON fields merged into the JSON edit body last (can override the
      * built-in defaults), e.g. SenseNova's `watermark`/`prompt_extend`.
@@ -169,11 +178,13 @@ export declare function resolveProvider(config: Config): {
     provider: 'google-sub';
     model: string;
 };
+/** Project one named relay channel onto the legacy flat fields used by all provider adapters. */
+export declare function withOpenAICompatChannel(config: Config, channelId?: string): Config;
 /**
  * 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;
+export declare function withProviderOverrides(config: Config, provider?: ImageProvider, model?: string, mode?: 'generate' | 'edit'): 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

package/lib/types/credentials.d.ts

@@ -5,11 +5,11 @@ import { type CloudImageProvider } from './shared.js';
  * 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>;
+export declare function resolveApiKey(ctx: Context, provider: CloudImageProvider, keyRef?: string): 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>;
+export declare function requireApiKey(ctx: Context, provider: CloudImageProvider, tool?: string, keyRef?: string): Promise<string>;

package/lib/types/generation-timeout.d.ts

@@ -0,0 +1,5 @@
+export declare const UPSTREAM_TIMEOUT_HINT = "\u4E0A\u6E38\u53EF\u80FD\u5DF2\u6263\u8D39\u6216\u4ECD\u5728\u751F\u6210\uFF0C\u8BF7\u5230\u670D\u52A1\u5546\u540E\u53F0\u786E\u8BA4";
+export declare class GenerationTimeoutError extends Error {
+    constructor(timeoutMs: number);
+}
+export declare function withGenerationTimeout<T>(timeoutMs: number, signal: AbortSignal, operation: (signal: AbortSignal) => Promise<T>): Promise<T>;

package/lib/types/image-tool-context.d.ts

@@ -0,0 +1,3 @@
+/** Live, credential-free instructions for the conversation model's image tools. */
+import { type Config } from './config.js';
+export declare function imageToolContext(config: Config): string;

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

@@ -32,7 +32,7 @@ export declare function generateOpenAICompatibleImage(input: {
     arkOptions?: ArkOutputOptions;
 }): Promise<GeneratedCompatibleImage>;
 /** How the edits endpoint expects its request body (#41). */
-export type CompatEditFormat = 'multipart' | 'jsonImageUrlArray' | 'formReferenceImages' | 'xaiJson' | 'qwenJson';
+export type CompatEditFormat = 'multipart' | 'jsonImageUrlArray' | 'formReferenceImages' | 'siliconflowJson' | 'xaiJson' | 'qwenJson';
 export declare function editOpenAICompatibleImage(input: {
     apiKey: string;
     baseURL: string;

package/lib/types/shared.d.ts

@@ -141,6 +141,48 @@ export declare function isSubscriptionProvider(provider: ImageProvider): provide
 /** Providers supported by the first browser workbench release. */
 export declare const CLOUD_IMAGE_PROVIDERS: readonly ["google", "openai", "openai-compat", "seedream", "dashscope", "xai", "zhipu"];
 export type CloudImageProvider = typeof CLOUD_IMAGE_PROVIDERS[number];
+/** Normalize the relay model list while keeping the legacy default model selectable. */
+export declare function resolveOpenAICompatModels(config: {
+    openaiCompatModel?: string;
+    openaiCompatModels?: readonly string[];
+}): string[];
+export declare const DEFAULT_OPENAI_COMPAT_CHANNEL_ID = "default";
+export interface OpenAICompatChannel {
+    id: string;
+    label: string;
+    keyRef: string;
+    baseURL: string;
+    model: string;
+    models?: string[];
+    editModel?: string;
+    quality?: string;
+    qualityOptions?: string[];
+    extraBody?: Record<string, unknown>;
+    editSizeMode?: 'auto' | 'selected';
+    editFormat?: 'multipart' | 'jsonImageUrlArray' | 'formReferenceImages' | 'siliconflowJson';
+    editExtra?: Record<string, unknown>;
+    sizes?: Record<string, Record<string, string>>;
+}
+export interface OpenAICompatChannelSource {
+    openaiCompatLabel?: string;
+    openaiCompatBaseURL?: string;
+    openaiCompatModel?: string;
+    openaiCompatModels?: readonly string[];
+    openaiCompatEditModel?: string;
+    openaiCompatQuality?: string;
+    openaiCompatQualityOptions?: readonly string[];
+    openaiCompatExtraBody?: Record<string, unknown>;
+    openaiCompatEditSizeMode?: 'auto' | 'selected';
+    openaiCompatEditFormat?: 'multipart' | 'jsonImageUrlArray' | 'formReferenceImages' | 'siliconflowJson';
+    openaiCompatEditExtra?: Record<string, unknown>;
+    openaiCompatSizes?: Record<string, Record<string, string>>;
+    openaiCompatChannels?: readonly OpenAICompatChannel[];
+    openaiCompatActiveChannel?: string;
+}
+export declare function openAICompatKeyRef(channelId: string): string;
+/** The legacy flat fields remain the first channel; additional entries are fully independent. */
+export declare function resolveOpenAICompatChannels(source: OpenAICompatChannelSource): OpenAICompatChannel[];
+export declare function resolveOpenAICompatChannel(source: OpenAICompatChannelSource, channelId?: string): OpenAICompatChannel;
 /**
  * Providers the browser workbench can drive: the BYOK cloud set plus the
  * logged-in subscription channels. ComfyUI stays out; it has its own workflow
@@ -148,8 +190,11 @@ export type CloudImageProvider = typeof CLOUD_IMAGE_PROVIDERS[number];
  */
 export declare const STUDIO_PROVIDERS: readonly ["google", "openai", "openai-compat", "seedream", "dashscope", "xai", "zhipu", "chatgpt-sub", "grok-sub", "google-sub"];
 export type StudioProvider = CloudImageProvider | SubscriptionProvider;
+export declare function studioTargetKey(provider: StudioProvider, channel?: string): string;
 /** True when the provider is selectable in the browser workbench. */
 export declare function isStudioProvider(provider: ImageProvider): provider is StudioProvider;
+/** Default timeout for API-key cloud generation in the browser workbench. */
+export declare const DEFAULT_CLOUD_TIMEOUT_MS = 150000;
 /** Timeout for one subscription image call, shared by the tool path and the
  * studio route so neither drifts from the other. */
 export declare const SUBSCRIPTION_TIMEOUT_MS = 300000;
@@ -198,8 +243,14 @@ export interface StudioWatermarkCapability {
 /** Browser-safe provider description. Credentials and endpoints never cross this boundary. */
 export interface StudioProviderProfile {
     provider: StudioProvider;
+    /** OpenAI-compatible channel id; absent for every other provider. */
+    channel?: string;
     label: string;
     model: string;
+    /** Separate configured edit model; absent preserves the generation model. */
+    editModel?: string;
+    /** Selectable generation models; absent means the single default model. */
+    modelOptions?: StudioOption[];
     configured: boolean;
     supportsEditing: boolean;
     ratioOptions: StudioOption[];
@@ -216,6 +267,9 @@ export interface StudioProviderProfile {
     watermarkOptions?: StudioOption[];
     watermarkCapabilities?: Record<'generate' | 'edit', StudioWatermarkCapability>;
 }
+/** A model picker/request must use the same operation-specific default. */
+export declare function studioModelForMode(profile: StudioProviderProfile, mode: 'generate' | 'edit'): string;
+export declare function studioModelOptionsForMode(profile: StudioProviderProfile, mode: 'generate' | 'edit'): StudioOption[];
 export declare function studioWatermarkCapability(profile: StudioProviderProfile | undefined, mode: 'generate' | 'edit'): StudioWatermarkCapability;
 /** Lightweight workspace description exposed to the client for scoping. */
 export interface StudioWorkspaceInfo {
@@ -228,6 +282,7 @@ export interface StudioWorkspaceInfo {
 export interface StudioConfigResponse {
     providers: StudioProviderProfile[];
     activeProvider: StudioProvider;
+    activeChannel?: string;
     workspaceRoot?: string | undefined;
     workspaces?: StudioWorkspaceInfo[] | undefined;
 }
@@ -246,6 +301,7 @@ export type StudioReference = StudioEncodedReference | StudioAttachmentReference
 export interface StudioGenerateRequest {
     mode: 'generate' | 'edit';
     provider: StudioProvider;
+    channel?: string;
     model: string;
     prompt: string;
     ratio: string;
@@ -268,6 +324,7 @@ export interface StudioGeneratedItem {
 /** One completed workbench request. */
 export interface StudioGenerateResponse extends StudioGeneratedItem {
     provider: StudioProvider;
+    channel?: string;
     model: string;
     prompt: string;
     createdAt: number;

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

@@ -5,6 +5,7 @@ export interface StudioRouteDeps {
     describe(): Promise<StudioConfigResponse>;
     generate(input: StudioGenerateRequest, signal: AbortSignal): Promise<StudioGenerateResponse>;
     maxBodyBytes: number;
+    timeoutMs?: number;
     /** Heartbeat cadence for the streaming generation response; tests shrink it. */
     heartbeatMs?: number;
 }

package/lib/types/studio.d.ts

@@ -31,4 +31,4 @@ export declare function describeStudio(ctx: Context, config: Config, subscriptio
 /** 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, subscriptions?: SubscriptionManager | undefined): Promise<StudioGenerateResponse>;
 export declare function runPool<T>(tasks: Array<() => Promise<T>>, concurrency?: number): Promise<PromiseSettledResult<T>[]>;
-export declare function studioProfile(config: Config, provider: CloudImageProvider, configured: boolean): StudioProviderProfile;
+export declare function studioProfile(config: Config, provider: CloudImageProvider, configured: boolean, channelId?: string): StudioProviderProfile;

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

@@ -1,6 +1,6 @@
 /** 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 Config, type ImageProvider } from './config.js';
 import type { SubscriptionManager } from './subscription.js';
 import { type CloudImageProvider } from './shared.js';
 export { TEST_CONNECTION_ROUTE } from './shared.js';
@@ -71,8 +71,8 @@ export declare function probeComfyUIConnection(config: Config, signal?: AbortSig
 export declare function probeSubscriptionConnection(provider: 'chatgpt-sub' | 'grok-sub' | 'google-sub', manager: SubscriptionManager): 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 credential each cloud provider or named relay channel probes with, when one is stored. */
+    resolveKey(provider: CloudImageProvider, channel?: string): Promise<string | undefined>;
     /** The currently authoritative config, including unsaved defaults. */
     config(): Config;
     /** The internal subscription account manager for the login-state probes. */