dsh-image-gen 0.6.7 → 0.6.9

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

@@ -28,6 +28,12 @@ interface ImageSettings {
     openaiCompatEditExtra?: Record<string, unknown>;
     seedreamBaseURL?: string;
     seedreamModel?: string;
+    /** Ark `output_format`; `png` is lossless and keeps an alpha channel. */
+    seedreamOutputFormat?: 'png' | 'jpeg';
+    /** Ark `watermark`; off removes the baked-in "AI generated" mark. */
+    seedreamWatermark?: boolean;
+    /** Ark `background`; `transparent` needs an alpha-bearing edit reference. */
+    seedreamBackground?: 'opaque' | 'transparent';
     dashscopeEndpoint?: string;
     dashscopeModel?: string;
     xaiBaseURL?: string;
@@ -81,7 +87,7 @@ interface ImageCardFace {
     locale?: LocaleService | undefined;
     promoted: boolean;
 }
-type SettingsCardProps = PropsRuntime<'settings.plugin.item'> & InjectFace<SettingsFace>;
+type SettingsCardProps = PropsRuntime<'settings.plugins.tab'> & InjectFace<SettingsFace>;
 type ImageCardProps = PropsRuntime<'tool.call.toolview'> & InjectFace<ImageCardFace>;
 interface ImageResultNodeProps {
     node: {

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

@@ -1,4 +1,4 @@
-import type { CloudImageProvider, StudioProviderProfile } from '../shared.js';
+import type { StudioProvider, StudioProviderProfile } from '../shared.js';
 export interface ComparisonTarget {
     profile: StudioProviderProfile;
     ratio: string;
@@ -6,6 +6,6 @@ export interface ComparisonTarget {
     adjusted: boolean;
 }
 /** Map one shared output intent to settings accepted by every target model. */
-export declare function buildComparisonTargets(profiles: readonly StudioProviderProfile[], selectedProviders: readonly CloudImageProvider[], ratio: string, quality: string): ComparisonTarget[];
+export declare function buildComparisonTargets(profiles: readonly StudioProviderProfile[], selectedProviders: readonly StudioProvider[], ratio: string, quality: string): ComparisonTarget[];
 /** Start with two models, not every configured API, to avoid surprise spend. */
-export declare function initialComparisonProviders(profiles: readonly StudioProviderProfile[], activeProvider: CloudImageProvider): CloudImageProvider[];
+export declare function initialComparisonProviders(profiles: readonly StudioProviderProfile[], activeProvider: StudioProvider): StudioProvider[];

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

@@ -45,5 +45,5 @@ export declare function pillModelOf(provider: ImageProvider, value: PillSettings
 /** 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:#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-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/client/studio-chat-panel.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Workbench chat panel: the right-side DSH conversation surface.
+ *
+ * A dedicated archived agent session lives on the host side (studio-chat.ts);
+ * this panel pulls its projected event feed through CHAT_ROUTE with adaptive
+ * polling (?since=<seq> increments; faster while a turn is running, slower
+ * when idle, paused while the webview is hidden) and submits user turns with
+ * POST. Tool-generated images are mirrored onto the tldraw canvas through the
+ * landing queue and upserted into the gallery (the recent list refreshes via
+ * its subscription). The panel is intentionally unmount-friendly: re-pulls
+ * from seq 0 on remount, and both landing and gallery writes are deduped by
+ * attachmentId, so tab switches are safe.
+ */
+import { type FC } from 'react';
+/** Workspace scoping mirrored onto gallery records; shape-compatible with StudioWorkspaceProps. */
+export interface ChatWorkspaceScope {
+    workspaceId?: string | undefined;
+    path?: string | undefined;
+}
+export declare const StudioChatPanel: FC<{
+    lang: 'zh' | 'en';
+    workspace?: ChatWorkspaceScope | null | undefined;
+}>;

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

@@ -15,6 +15,10 @@ export interface StudioWorkspaceProps {
 }
 export declare const StudioView: FC<{
     locale?: LocaleService | undefined;
+    /** Host credential-change notifier; re-reads provider sign-in state silently. */
+    credentialEvents?: {
+        listen(callback: () => void): () => void;
+    } | undefined;
     workspace?: StudioWorkspaceProps | null | undefined;
     initialPrompt?: string | undefined;
     /**

package/lib/types/client/tl/diagram-landing.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Land one create_diagram result onto a tldraw page.
+ *
+ * Shapes and their arrow bindings are created in a single editor.run
+ * transaction, and a history stopping point is marked BEFORE the batch:
+ * tldraw's HistoryManager pops diffs until the next stop mark on undo, so
+ * without the mark two diagrams landing back-to-back would undo together.
+ * With it, each diagram is one independent undo step (undo/redo verified
+ * against the HistoryManager source and on the real canvas).
+ *
+ * Arrows are ELBOW connectors with BOTH terminals bound. Each terminal's
+ * binding side is derived from dagre's polyline: the first/last segment's
+ * dominant axis says which node edge the route uses (back edges leave the
+ * source's top and re-enter the target's bottom through the corridor dagre
+ * reserved, instead of tldraw guessing a center-to-center route). tldraw
+ * then re-routes the middle segments itself from the bindings — the
+ * polyline is a per-terminal side hint, not a full path contract. Whether
+ * the final arrows avoid crossing nodes and whether labels sit clear of
+ * geometry is validated on the real canvas, not assumed here.
+ *
+ * Derived anchors are clamped to the middle band (0.2–0.8) of their edge:
+ * tldraw's getEdgeFromNormalizedAnchor resolves the side via |x-0.5| vs
+ * |y-0.5|, and a corner-ish anchor could resolve to the wrong side.
+ *
+ * Edge labels set labelPosition from dagre's arc-length ratio — a
+ * best-effort estimate, since tldraw applies the ratio to its own routed
+ * path.
+ *
+ * Self loops (empty dagre polyline) fall back to center bindings: tldraw
+ * draws bound self-loop arrows natively.
+ *
+ * Every created shape carries meta.diagramId, the same dedupe identity the
+ * landing reconcile uses for images' meta.galleryId.
+ */
+import { type Editor } from 'tldraw';
+import { type DiagramLayout, type DiagramLayoutEdge, type DiagramLayoutNode, type DiagramPoint } from './diagram-layout.js';
+import type { TlDiagramLanding } from './tl-canvas-bridge.js';
+/** Terminal binding plan: the precise anchor, or a center fallback. */
+export interface TerminalPlan {
+    anchor: {
+        x: number;
+        y: number;
+    };
+    precise: boolean;
+}
+/**
+ * Derive one terminal's binding side + precise anchor from dagre's
+ * polyline. The boundary point sits ON the node outline (dagre guarantees
+ * this via its node-intersection pass), so the binding side is the OUTLINE
+ * EDGE CLOSEST TO THE BOUNDARY POINT — not the segment direction. The last
+ * segment often enters at an angle because dagre projects the corridor
+ * point onto the outline (e.g. a back edge entering the target's bottom
+ * with a final dx=57, dy=-48 segment), and direction-dominance would
+ * misread that as `right`. The segment direction is only used to break
+ * exact corner ties. The boundary point gives the cross-axis position,
+ * clamped to the anchor band.
+ */
+export declare function terminalPlan(node: Pick<DiagramLayoutNode, 'x' | 'y' | 'w' | 'h'>, boundary: DiagramPoint, next: DiagramPoint): TerminalPlan;
+/**
+ * Binding plans for one edge's two terminals. Self loops (no dagre
+ * polyline) get center plans: tldraw renders bound self loops natively.
+ */
+export declare function edgeTerminalPlans(edge: DiagramLayoutEdge, fromNode: DiagramLayoutNode, toNode: DiagramLayoutNode): {
+    start: TerminalPlan;
+    end: TerminalPlan;
+};
+/**
+ * Land one diagram with its top-left at `origin`. The caller passes the
+ * precomputed layout (it needs the layout bounds to pick the origin, so the
+ * layout is computed once and shared). No-op on empty layouts.
+ */
+export declare function landDiagram(editor: Editor, landing: TlDiagramLanding, layout: DiagramLayout, origin: {
+    x: number;
+    y: number;
+}): void;

package/lib/types/client/tl/diagram-layout.d.ts

@@ -0,0 +1,76 @@
+import type { DiagramNodeShape, DiagramSpec } from '../../shared.js';
+/** One laid-out node: local id, label, outline, top-left position, size. */
+export interface DiagramLayoutNode {
+    id: string;
+    label: string;
+    shape: DiagramNodeShape;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** A point in graph space (same origin as the layout nodes). */
+export interface DiagramPoint {
+    x: number;
+    y: number;
+}
+/** One laid-out edge between node local ids, with dagre's routing hint. */
+export interface DiagramLayoutEdge {
+    from: string;
+    to: string;
+    label?: string;
+    /**
+     * dagre's polyline in graph space. points[0] lies on the source node's
+     * outline and points[last] on the target's. Self loops carry an empty
+     * array: dagre cannot route them, and the landing layer falls back to
+     * center bindings (tldraw draws bound self loops natively).
+     */
+    points: DiagramPoint[];
+    /**
+     * Where the label sits along the polyline, as an arc-length ratio in
+     * [0, 1] (tldraw's arrow labelPosition shares the ratio semantics). This
+     * is a best-effort initial estimate: tldraw applies the ratio to its own
+     * routed path, which may differ from dagre's polyline in the middle
+     * segments. The final label position is validated on the real canvas.
+     */
+    labelPosition?: number;
+}
+export interface DiagramLayout {
+    nodes: DiagramLayoutNode[];
+    edges: DiagramLayoutEdge[];
+    width: number;
+    height: number;
+    /** Growth direction of the layout, needed by the landing layer to pick
+     * binding anchors (TB connects bottom→top edges, LR right→left edges). */
+    direction: 'TB' | 'LR';
+}
+/** Node size in canvas units (top-left anchored, like tldraw shape props). */
+export interface DiagramSize {
+    w: number;
+    h: number;
+}
+/** Measured sizes fed into the pure layout function. */
+export interface DiagramMeasurements {
+    /** node id → measured node size. Missing entries fall back to the default. */
+    nodes: ReadonlyMap<string, DiagramSize>;
+    /**
+     * edge list index → measured label size. Only edges carrying a label are
+     * present; dagre reserves rank space for these labels.
+     */
+    edgeLabels?: ReadonlyMap<number, DiagramSize>;
+}
+/** Fallback size for nodes the caller did not measure (defensive only). */
+export declare const DEFAULT_NODE_SIZE: DiagramSize;
+/**
+ * Where a point sits along a polyline, as an arc-length ratio in [0, 1].
+ * The point is projected onto the nearest polyline segment. Degenerate
+ * polylines return 0.5.
+ */
+export declare function arcRatioAlongPolyline(points: readonly DiagramPoint[], target: DiagramPoint): number;
+/**
+ * Lay out a diagram spec with coordinates relative to (0, 0). The layout is
+ * deterministic: same spec + same measurements always produce the same
+ * coordinates (dagre is seeded by insertion order, which we keep stable by
+ * iterating the spec's arrays as given).
+ */
+export declare function layoutDiagram(diagram: DiagramSpec, measurements: DiagramMeasurements): DiagramLayout;

package/lib/types/client/tl/diagram-measure.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Measure diagram node/edge-label sizes with tldraw's own DOM text measuring.
+ *
+ * This is the "real" half of the measurement/layout split: the editor's
+ * TextManager renders text with the same font family, size, line height and
+ * wrap width the landed geo shapes will use, so RECTANGLE node sizes track
+ * the rendered label 1:1 (no character-width heuristics).
+ *
+ * The measure parameters mirror tldraw's internal geo-shape constants for
+ * our landed shapes (font 'sans', size 'm'): theme.fontSize * 1.375,
+ * theme.lineHeight, label padding 16.
+ *
+ * Non-rectangular outlines are APPROXIMATE, not 1:1. tldraw re-wraps the
+ * label against the SHAPE's width (shape w - padding), and we size the
+ * shape from the text measured at the pre-inflation wrap width — so after
+ * inflation the label re-wraps into fewer, wider lines. For short labels
+ * (single line at the wrap width) the geometry below is exact. For long
+ * wrapped labels the re-wrapped block can grow past the outline's inscribed
+ * rectangle and crowd the diamond's slanted edges / the ellipse's arc:
+ * greedy text wrapping scales with shape width while the inscribed rectangle
+ * only halves it, so there is no closed-form fix. The create_diagram tool
+ * prompt steers long text to rectangles and keeps diamond labels short;
+ * whether a real label fits is ultimately a visual check on the real canvas
+ * (see the diagram-verify harness), not something this module can promise.
+ *   - diamond: a single-line text rect (tw, th) fits exactly when
+ *     tw/w + th/h <= 1, so doubling the text size (+ padding) is exact for
+ *     unwrapped labels.
+ *   - ellipse: a single-line corner point fits exactly when
+ *     tw²/w² + th²/h² <= 1, so a √2 factor (+ padding) is exact for
+ *     unwrapped labels.
+ */
+import type { Editor } from 'tldraw';
+import type { DiagramSpec } from '../../shared.js';
+import type { DiagramMeasurements } from './diagram-layout.js';
+/**
+ * Measure every node and edge label of a spec against the editor's live
+ * theme and fonts. Node sizes carry the outline inflation for diamond and
+ * ellipse; edge-label sizes let dagre reserve rank space for labels.
+ */
+export declare function measureDiagram(editor: Editor, diagram: DiagramSpec): DiagramMeasurements;

package/lib/types/config.d.ts

@@ -1,7 +1,7 @@
 /** 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, 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, };
+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, };
 /** Default workspace subfolder that receives generated image files. */
 export declare const DEFAULT_WORKSPACE_FOLDER = "dsh-image-gen";
 /** Google tool-level controls. */
@@ -34,6 +34,22 @@ export interface Config {
     openaiCompatEditExtra?: Record<string, unknown>;
     seedreamBaseURL?: string;
     seedreamModel?: string;
+    /**
+     * Ark `output_format`. Ark defaults to `jpeg`, which is lossy and cannot
+     * carry an alpha channel; `png` is lossless, so it survives later editing
+     * (e.g. background removal) without JPEG ringing around the subject.
+     */
+    seedreamOutputFormat?: ArkOutputFormat;
+    /**
+     * Ark `watermark`. Ark defaults to `true`, which bakes an "AI generated"
+     * mark into the bottom-right corner.
+     */
+    seedreamWatermark?: boolean;
+    /**
+     * Ark `background`. Only the edit path can honour `transparent`, and only
+     * when every reference image already carries an alpha channel.
+     */
+    seedreamBackground?: ArkBackgroundMode;
     dashscopeEndpoint?: string;
     dashscopeModel?: string;
     xaiBaseURL?: string;
@@ -85,6 +101,7 @@ export declare function resolveProvider(config: Config): {
     model: string;
     baseURL: string;
     imageSize: string;
+    arkOptions: ArkOutputOptions;
 } | {
     provider: 'dashscope';
     apiKeyEnv: string;

package/lib/types/diagram.d.ts

@@ -0,0 +1,42 @@
+/**
+ * create_diagram: a structure-only tool whose results land on the workbench
+ * infinite canvas.
+ *
+ * The model outputs a declarative DSL (nodes + edges with local ids, never
+ * coordinates). The tool call succeeds immediately — exactly like image
+ * generation — and the diagram rides the same landing bus: an open canvas
+ * renders it at once, a closed one renders it the moment it opens. The canvas
+ * computes the layered layout, creates geo shapes, and binds every arrow to
+ * its endpoints so the user can drag nodes around with arrows following.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type DiagramDirection, type DiagramEdgeSpec, type DiagramNodeSpec } from './shared.js';
+/** Value returned by create_diagram and echoed into the tool-result schema. */
+export interface CreateDiagramValue {
+    diagramId: string;
+    title: string;
+    direction: DiagramDirection;
+    nodeCount: number;
+    edgeCount: number;
+}
+/** Untrusted create_diagram arguments as they arrive from the model. */
+export interface CreateDiagramArgs {
+    title?: unknown;
+    direction?: unknown;
+    nodes?: unknown;
+    edges?: unknown;
+}
+/** Register the create_diagram tool on a host context. */
+export declare function registerDiagramTool(ctx: Context): void;
+/**
+ * Validate untrusted create_diagram arguments into a DiagramSpec. Returns
+ * undefined for anything structurally unusable (no nodes, duplicate ids,
+ * edges pointing at unknown nodes, over the caps) — the tool then fails with
+ * an actionable message and the model can retry with a corrected diagram.
+ */
+export declare function diagramSpecFromArgs(args: CreateDiagramArgs): {
+    title?: string;
+    direction?: DiagramDirection;
+    nodes: DiagramNodeSpec[];
+    edges: DiagramEdgeSpec[];
+} | undefined;

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

@@ -1,5 +1,6 @@
 /** OpenAI Images API and compatible response adapter. */
 import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
+import { type ArkOutputOptions } from './shared.js';
 export interface GeneratedCompatibleImage {
     data: Uint8Array;
     mediaType: ImageMediaType;
@@ -17,6 +18,8 @@ export declare function generateOpenAICompatibleImage(input: {
     size: string;
     maxBytes: number;
     signal: AbortSignal;
+    /** Ark-only output controls; ignored by every other provider. */
+    arkOptions?: ArkOutputOptions;
 }): Promise<GeneratedCompatibleImage>;
 /** How the edits endpoint expects its request body (#41). */
 export type CompatEditFormat = 'multipart' | 'jsonImageUrlArray';

package/lib/types/seedream.d.ts

@@ -1,6 +1,7 @@
 /** Volcengine Ark Seedream image-editing adapter. */
 import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
 import type { GeneratedCompatibleImage } from './openai-compatible.js';
+import { type ArkOutputOptions } from './shared.js';
 /** Edit one image through Ark ImageGenerations using a data-URL reference. */
 export declare function editSeedreamImage(input: {
     apiKey: string;
@@ -14,4 +15,10 @@ export declare function editSeedreamImage(input: {
     size?: string;
     maxBytes: number;
     signal: AbortSignal;
+    /**
+     * Ark output controls. The edit path is the only one Ark lets request a
+     * transparent background, and it requires every reference image to carry an
+     * alpha channel — see `arkOutputBody`.
+     */
+    arkOptions?: ArkOutputOptions;
 }): Promise<GeneratedCompatibleImage>;

package/lib/types/shared.d.ts

@@ -117,6 +117,18 @@ 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];
+/**
+ * Providers the browser workbench can drive: the BYOK cloud set plus the
+ * logged-in subscription channels. ComfyUI stays out; it has its own workflow
+ * pipeline and no shared request shape.
+ */
+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;
+/** True when the provider is selectable in the browser workbench. */
+export declare function isStudioProvider(provider: ImageProvider): provider is StudioProvider;
+/** 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;
 /**
  * Credential references resolved through the DSH Credentials service (BYOK).
  * These are POSIX-style reference names, not environment variables: the host
@@ -155,7 +167,7 @@ export interface StudioOption {
 }
 /** Browser-safe provider description. Credentials and endpoints never cross this boundary. */
 export interface StudioProviderProfile {
-    provider: CloudImageProvider;
+    provider: StudioProvider;
     label: string;
     model: string;
     configured: boolean;
@@ -175,7 +187,7 @@ export interface StudioWorkspaceInfo {
 /** Read model and capability state for the workbench without exposing secrets. */
 export interface StudioConfigResponse {
     providers: StudioProviderProfile[];
-    activeProvider: CloudImageProvider;
+    activeProvider: StudioProvider;
     workspaceRoot?: string | undefined;
     workspaces?: StudioWorkspaceInfo[] | undefined;
 }
@@ -193,7 +205,7 @@ export type StudioReference = StudioEncodedReference | StudioAttachmentReference
 /** One browser workbench generation or editing request. */
 export interface StudioGenerateRequest {
     mode: 'generate' | 'edit';
-    provider: CloudImageProvider;
+    provider: StudioProvider;
     model: string;
     prompt: string;
     ratio: string;
@@ -211,7 +223,7 @@ export interface StudioGeneratedItem {
 }
 /** One completed workbench request. */
 export interface StudioGenerateResponse extends StudioGeneratedItem {
-    provider: CloudImageProvider;
+    provider: StudioProvider;
     model: string;
     prompt: string;
     createdAt: number;
@@ -235,6 +247,45 @@ 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";
 export declare const MAX_COMFYUI_WORKFLOW_BYTES: number;
+/** Content types Ark's Seedream endpoint can return. */
+export declare const ARK_OUTPUT_FORMATS: readonly ["png", "jpeg"];
+/** Whether Ark stamps an "AI generated" watermark on the result. */
+export declare const ARK_BACKGROUND_MODES: readonly ["opaque", "transparent"];
+export type ArkOutputFormat = typeof ARK_OUTPUT_FORMATS[number];
+export type ArkBackgroundMode = typeof ARK_BACKGROUND_MODES[number];
+/**
+ * Ark (Seedream) output controls, shared by the generate and edit paths.
+ *
+ * Every field mirrors an Ark request-body field of the same meaning, and every
+ * default below reproduces Ark's own default — so an untouched configuration
+ * sends exactly what it sent before these options existed.
+ */
+export interface ArkOutputOptions {
+    /** `output_format`. Ark defaults to `jpeg`; `png` is lossless and keeps an alpha channel. */
+    outputFormat?: ArkOutputFormat;
+    /** `watermark`. Ark defaults to `true`, which bakes an "AI generated" mark into the image. */
+    watermark?: boolean;
+    /** `background`. Ark defaults to `opaque`. */
+    background?: ArkBackgroundMode;
+}
+/**
+ * Map the Ark output controls onto request-body fields.
+ *
+ * `background` is opt-in per call site because Ark restricts `transparent` to
+ * image-to-image with a single alpha-bearing reference and rejects the whole
+ * request otherwise:
+ *
+ *   text-to-image + transparent → 400 InvalidParameter
+ *     "transparent background requires exactly one input image"
+ *
+ * So the generation endpoint must never carry it, and that caller passes
+ * `{ background: false }`. `background: opaque` is never emitted anywhere: it
+ * is already Ark's default, so sending it would change nothing while adding a
+ * field only the edit path can act on.
+ */
+export declare function arkOutputBody(options: ArkOutputOptions | undefined, { background }?: {
+    background?: boolean;
+}): Record<string, unknown>;
 /** Default model names. */
 export declare const DEFAULT_GOOGLE_MODEL = "gemini-3.1-flash-image";
 export declare const DEFAULT_OPENAI_MODEL = "gpt-image-2";

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

@@ -0,0 +1,48 @@
+/**
+ * Dedicated DSH agent session backing the workbench chat panel.
+ *
+ * The panel is a real DSH conversation driven from the plugin, not a parallel
+ * chat implementation: on first use the host creates an agent through
+ * ctx.agents.create (the same factory the sidebar uses), then archives the
+ * session through ctx.workspaceRegistry so it never appears in the sidebar
+ * history list while remaining fully usable. The plugin never calls
+ * sessions.open - archiving the selected session would clear the user's
+ * current selection - and drives turns purely through agent.followup().
+ *
+ * Session events are projected into a small lossless-enough StudioChatEvent
+ * feed (text turns, tool summaries, generated-image references) and served to
+ * the browser through CHAT_ROUTE. The browser pulls increments with
+ * ?since=<seq>; images land on the tldraw canvas from the browser side via
+ * the existing IMAGE_ROUTE + landing-queue path.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { Context } from '@deepseek-ai/cordis';
+import { type StudioChatEvent } from './shared.js';
+/** Wire responses for CHAT_ROUTE. */
+export interface StudioChatStateResponse {
+    ok: true;
+    latestSeq: number;
+    events: StudioChatEvent[];
+    /** Why the backing agent is missing, when creation failed; absent otherwise. */
+    unavailable?: string;
+}
+export interface StudioChatSendResponse {
+    ok: true;
+}
+export interface StudioChatErrorResponse {
+    error: string;
+}
+export interface StudioChatDeps {
+    maxBodyBytes: number;
+}
+/**
+ * Install the studio chat: ensure the dedicated agent session, subscribe to
+ * its events, and return the CHAT_ROUTE handler plus a disposer. Creation
+ * failures never break the plugin load - the route reports the error and the
+ * panel shows it, so a host without agent services degrades visibly instead
+ * of fatally.
+ */
+export declare function createStudioChat(ctx: Context, deps: StudioChatDeps): {
+    serve: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+    dispose(): void;
+};

package/lib/types/studio.d.ts

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

package/lib/types/subscription/manager.d.ts

@@ -21,12 +21,26 @@ import { type SubscriptionBlob } from './blob.js';
 import { type SubscriptionProvider } from '../shared.js';
 /** Vendor ids used by the credential refs and the wire calls. */
 export type SubscriptionVendor = 'codex' | 'grok' | 'antigravity';
+/**
+ * Reference image passed to edit calls. Structural so callers can pass their
+ * own resolved types without importing from the plugin root.
+ */
+export interface SubscriptionReferenceImage {
+    data: Uint8Array;
+    mediaType: string;
+}
 /** The vendor each dsh-image-gen subscription provider maps onto. */
 export declare function vendorOf(provider: SubscriptionProvider): SubscriptionVendor;
 /** Credential ref one vendor's OAuth blob is stored under (index fixed at 1). */
 export declare function subscriptionOauthRef(vendor: SubscriptionVendor): CredentialRef;
 /** Sizes both vendors understand. */
 export declare const SUBSCRIPTION_SIZES: readonly ["1024x1024", "1024x1536", "1536x1024", "auto"];
+/**
+ * Reference images per edit call. Every subscription channel accepts at
+ * least this many (Codex edits up to 16, Grok up to 5, Antigravity up to 10),
+ * so 5 keeps one shared guard in line with the Studio UI's upload cap.
+ */
+export declare const SUBSCRIPTION_MAX_REFERENCE_IMAGES = 5;
 /** Login status the settings card renders as a badge. */
 export type SubscriptionLoginStatus = {
     state: 'logged-in';
@@ -80,6 +94,7 @@ export declare class SubscriptionManager {
         prompt: string;
         size?: string;
         quality?: string;
+        referenceImages?: ReadonlyArray<SubscriptionReferenceImage>;
         signal?: AbortSignal;
     }): Promise<Array<{
         b64_json: string;

package/lib/types/subscription/vendors/antigravity.d.ts

@@ -37,12 +37,17 @@ export declare function antigravityResolveProject(blob: SubscriptionBlob): Promi
  * Build the streamGenerateContent request body for one image generation.
  * Ported from the reference buildImageRequest + the wrapping envelope: no
  * tools, no systemInstruction, no thinkingConfig; responseModalities asks
- * for TEXT+IMAGE.
+ * for TEXT+IMAGE. Reference images (edits) ride along as inlineData parts
+ * before the text part, mirroring the reference implementation.
  */
 export declare function antigravityImageBody(options: {
     prompt: string;
     aspectRatio?: string;
     hd?: boolean;
+    referenceImages?: ReadonlyArray<{
+        data: Uint8Array;
+        mediaType: string;
+    }>;
 }): Record<string, unknown>;
 /** Wrap the inner request in the Antigravity agent envelope. */
 export declare function antigravityEnvelope(projectId: string, request: Record<string, unknown>): Record<string, unknown>;
@@ -62,5 +67,9 @@ export declare function antigravityGenerateImage(options: {
     prompt: string;
     aspectRatio?: string;
     hd?: boolean;
+    referenceImages?: ReadonlyArray<{
+        data: Uint8Array;
+        mediaType: string;
+    }>;
     signal?: AbortSignal;
 }): Promise<AntigravityImageResult>;

package/lib/types/subscription/vendors/codex.d.ts

@@ -12,6 +12,8 @@ export declare const CODEX_AUTH = "https://auth.openai.com/oauth/authorize";
 export declare const CODEX_TOKEN = "https://auth.openai.com/oauth/token";
 /** Where the ChatGPT subscription image request goes. */
 export declare const CODEX_IMAGE_URL = "https://chatgpt.com/backend-api/codex/images/generations";
+/** Where the ChatGPT subscription image edit request goes. */
+export declare const CODEX_IMAGE_EDIT_URL = "https://chatgpt.com/backend-api/codex/images/edits";
 /** The model served by this endpoint (probed live: gpt-image-2.5-flare works
  * on the ChatGPT internal generations route as of 2026-09-14). */
 export declare const CODEX_IMAGE_MODEL = "gpt-image-2.5-flare";