dsh-image-gen 0.6.11 → 0.7.0

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

@@ -228,6 +228,16 @@ export interface GalleryViewTabProps {
     defaultTab?: TabKey;
     /** Canvas surface the studio opens with; the sidebar variant shows the tldraw infinite canvas directly. */
     initialCanvasSurface?: 'preview' | 'infinite';
+    /**
+     * Sidebar tab visibility reader injected by DSH's `sidebar.right.pane.tab`
+     * seat (absent on hosts that mount this view elsewhere, e.g. the main-area
+     * conversation tab, where the hook is optional).
+     */
+    useTabInfo?: (() => {
+        tab?: {
+            visible?: boolean;
+        };
+    }) | undefined;
 }
 export declare const GalleryViewTab: FC<GalleryViewTabProps>;
 export { copyImageBlob } from './browser-image-utils.js';

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

@@ -7,7 +7,8 @@ export interface SettingsScopeSnapshot<T> {
 export interface SettingsScope<T> {
     getSnapshot(): SettingsScopeSnapshot<T>;
     subscribe(listener: () => void): () => void;
-    set(field: string, value: unknown): Promise<void>;
+    /** New hosts return true/false; legacy settings scopes resolve to void. */
+    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';
@@ -97,7 +98,13 @@ interface ImageResultNodeProps {
     };
     locale?: LocaleService | undefined;
 }
-/** Required browser services. */
+/**
+ * Required browser services. The settings form reader is deliberately absent:
+ * DSH 0.1.7 serves it as `configForms` (keyed by the Loader entry id) while
+ * 0.1.5/0.1.6 expose `settingsScope` (keyed by the legacy namespace), so it is
+ * probed at runtime in `apply`. A static inject of either name would park this
+ * fiber forever on hosts from the other generation — the issue #55 failure.
+ */
 export declare const inject: string[];
 /** Mount the settings card, generated-image card, and native conversation gallery view. */
 export declare function apply(ctx: Context): void;

package/lib/types/client/settings-write.d.ts

@@ -0,0 +1,4 @@
+/** DSH 0.1.7 resolves refused writes to false; older settings scopes resolve to void. */
+export declare function writeSetting(scope: {
+    set(field: string, value: unknown): Promise<boolean | void>;
+}, field: string, value: unknown, rejectedMessage: string): Promise<void>;

package/lib/types/client/tl/studio-tl-canvas.d.ts

@@ -1,6 +1,13 @@
 import { type FC } from 'react';
 /** Reset canvas-owned data only. Gallery records and host attachments are untouched. */
 export declare function clearStudioTlCanvases(): boolean;
+/**
+ * Cancel in-editor selection on every mounted canvas, keeping shapes and sync
+ * untouched. Selection is interaction state tied to the surface: leaving the
+ * studio page cancels it so a stale selection can neither resurface on return
+ * nor linger in the host mirror.
+ */
+export declare function deselectStudioTlCanvases(): boolean;
 export declare const StudioTlCanvas: FC<{
     lang?: 'zh' | 'en';
 }>;

package/lib/types/config.d.ts

@@ -70,8 +70,14 @@ export interface Config {
     saveToWorkspace?: boolean;
     /** Workspace subfolder for generated images; empty means the workspace root. */
     workspaceFolder?: string;
+    /** Show the provider switcher beside the chat input. */
+    showProviderPill?: boolean;
 }
-/** Cordis configuration schema. */
+/**
+ * Cordis configuration schema. Volatile marking happens per field (see
+ * `volatile`); the `z<Config>` annotation keeps the plain output type for the
+ * rest of the codebase because the wrapping is unwrapped at the entry.
+ */
 export declare const Config: z<Config>;
 /** Resolve exactly one provider profile for a tool call. */
 export declare function resolveProvider(config: Config): {

package/lib/types/shared.d.ts

@@ -112,6 +112,12 @@ export interface CanvasStatePush {
 }
 /** Namespace persisted through DSH Settings. */
 export declare const IMAGE_GENERATION_NAMESPACE = "image-generation";
+/**
+ * Loader entry id of this plugin's composition entry (see cordis.patch.yml).
+ * DSH 0.1.7 serves a plugin's settings under its entry id as the namespace,
+ * so browser-side reads/writes bind `configForms` to this id.
+ */
+export declare const IMAGE_GENERATION_ENTRY_ID = "image-gen";
 /** Supported providers. */
 export declare const IMAGE_PROVIDERS: readonly ["google", "openai", "openai-compat", "seedream", "dashscope", "xai", "zhipu", "comfyui", "chatgpt-sub", "grok-sub", "google-sub"];
 export type ImageProvider = typeof IMAGE_PROVIDERS[number];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-image-gen",
-  "version": "0.6.11",
+  "version": "0.7.0",
   "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope, local ComfyUI & more.",
   "type": "module",
   "author": "shanliuling",
@@ -106,25 +106,25 @@
     }
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/dsh-agent": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-connection": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-client-ui-tool": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-credentials": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-host-webserver": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.1",
-    "@deepseek-ai/dsh-workspace": "0.1.5-rc.1",
-    "@deepseek-ai/schemastery": "3.18.1",
+    "@deepseek-ai/cordis": "4.0.4",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-host-webserver": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-workspace": "0.1.7-rc.2",
+    "@deepseek-ai/schemastery": "3.18.4",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "react": "^18.2.0",

package/lib/types/client/canvas/canvas-bridge.d.ts

@@ -1,10 +0,0 @@
-import type { StudioProviderProfile } from '../../shared.js';
-export interface CanvasBridge {
-    updateNodeData: (nodeId: string, patch: Record<string, unknown>) => void;
-    requestGenerate: (nodeId: string) => void;
-    deleteNode: (nodeId: string) => void;
-    profiles: readonly StudioProviderProfile[];
-    lang: 'zh' | 'en';
-}
-export declare const CanvasBridgeContext: import("react").Context<CanvasBridge | undefined>;
-export declare function useCanvasBridge(): CanvasBridge | undefined;

package/lib/types/client/canvas/canvas-model.d.ts

@@ -1,129 +0,0 @@
-/**
- * Canvas domain model: pure node/edge helpers shared by the canvas view,
- * the import bridge and unit tests. No React, no IO.
- */
-import { type Edge, type Node } from '@xyflow/react';
-import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
-import type { StudioGenerateRequest, StudioProviderProfile } from '../../shared.js';
-export interface ImageNodeData extends Record<string, unknown> {
-    kind: 'image';
-    /** Durable attachment-backed image (generated results, conversation imports). */
-    attachment?: ImageAttachmentRef;
-    /** Locally uploaded image kept as base64 until used as a generation reference. */
-    encoded?: {
-        mediaType: string;
-        data: string;
-    };
-    prompt?: string;
-    pending?: boolean;
-    error?: string;
-}
-export interface TextNodeData extends Record<string, unknown> {
-    kind: 'text';
-    text: string;
-}
-export interface ConfigNodeData extends Record<string, unknown> {
-    kind: 'config';
-    provider: string;
-    model: string;
-    prompt: string;
-    ratio: string;
-    quality: string;
-    count: number;
-    generating?: boolean;
-    error?: string;
-}
-export type CanvasNode = Node<ImageNodeData | TextNodeData | ConfigNodeData>;
-export type ConfigNode = Node<ConfigNodeData>;
-export interface CanvasDocument {
-    nodes: CanvasNode[];
-    edges: Edge[];
-    viewport?: {
-        x: number;
-        y: number;
-        zoom: number;
-    };
-    updatedAt: number;
-}
-/** Collision-safe node id (also stable across sessions via the random suffix). */
-export declare function newId(prefix: string): string;
-/** Stable node id for one attachment so repeated imports/generations dedupe. */
-export declare function imageNodeIdOf(attachmentId: string): string;
-export declare function nodeKindOf(node: CanvasNode | undefined): string | undefined;
-export declare function newTextNode(text: string | undefined, x: number, y: number): CanvasNode;
-export declare function newConfigNode(profile: StudioProviderProfile | undefined, x: number, y: number): CanvasNode;
-export declare function newImageNode(input: {
-    attachment?: ImageAttachmentRef;
-    encoded?: {
-        mediaType: string;
-        data: string;
-    };
-    prompt?: string;
-    pending?: boolean;
-    error?: string;
-    x: number;
-    y: number;
-}, id?: string): CanvasNode;
-/** Whether an edge is legal in the canvas graph: inputs feed configs, configs emit results, and images chain edits. */
-export declare function isLegalConnection(source: CanvasNode | undefined, target: CanvasNode | undefined): boolean;
-/** Everything a config node needs to know about its incoming edges. */
-export interface ResolvedInputs {
-    promptParts: string[];
-    referenceAttachments: ImageAttachmentRef[];
-    encodedReferences: Array<{
-        mediaType: string;
-        data: string;
-    }>;
-}
-export declare function resolveConfigInputs(nodes: readonly CanvasNode[], edges: readonly Edge[], configNodeId: string): ResolvedInputs;
-/** Build the studio request for one config node. Returns undefined when the prompt is empty. */
-export declare function buildGenerationRequest(config: ConfigNode, inputs: ResolvedInputs): StudioGenerateRequest | undefined;
-/** Position for the k-th output image spawned by one config node. */
-export declare function outputPosition(config: CanvasNode, existingOutputCount: number, index: number): {
-    x: number;
-    y: number;
-};
-/** One imported generation record (gallery item or pending bridge payload). */
-export interface ImportRecord {
-    attachmentId: string;
-    attachment: ImageAttachmentRef;
-    prompt?: string;
-    provider?: string;
-    model?: string;
-    createdAt?: number;
-    sourceAttachmentIds?: readonly string[];
-}
-/**
- * Canonical canvas edge factory: the closed arrowhead is baked in here so
- * generation edges, import edit-chain edges, and user-drawn edges all read
- * direction the same way (React Flow's defaultEdgeOptions never applies to
- * edges inserted directly through the edges state).
- */
-export declare function canvasEdge(source: string, target: string, className?: string): Edge;
-/** Rebuild image nodes and edit-chain edges from import records (ordered oldest first). */
-export declare function buildImportGraph(records: readonly ImportRecord[]): {
-    nodes: CanvasNode[];
-    edges: Edge[];
-};
-/** Merge an import graph into existing canvas state (nodes dedupe by id, edges by key). */
-export declare function mergeIntoCanvas(current: {
-    nodes: readonly CanvasNode[];
-    edges: readonly Edge[];
-}, incoming: {
-    nodes: readonly CanvasNode[];
-    edges: readonly Edge[];
-}, offset: {
-    x: number;
-    y: number;
-}): {
-    nodes: CanvasNode[];
-    edges: Edge[];
-};
-/** Drop volatile runtime flags (generating/pending/selected) — before persisting AND after restoring, so a remount never shows a phantom in-flight generation. */
-export declare function stripVolatile(node: CanvasNode): CanvasNode;
-/** Serialize the graph for persistence (strips volatile flags). */
-export declare function toDocument(nodes: readonly CanvasNode[], edges: readonly Edge[], viewport?: {
-    x: number;
-    y: number;
-    zoom: number;
-}): CanvasDocument;

package/lib/types/client/canvas/canvas-nodes.d.ts

@@ -1,23 +0,0 @@
-/**
- * Canvas node renderers: image (attachment or base64), text prompt, and the
- * generation config form. Data mutations flow through the canvas bridge
- * context, never through node data props.
- */
-import { type FC } from 'react';
-import { type NodeProps, type Node } from '@xyflow/react';
-import type { ConfigNodeData, ImageNodeData, TextNodeData } from './canvas-model.js';
-type ImageNodeType = Node<ImageNodeData, 'image'>;
-type TextNodeType = Node<TextNodeData, 'text'>;
-type ConfigNodeType = Node<ConfigNodeData, 'config'>;
-/** Attachment-backed or base64 image node; source handle feeds config nodes. */
-export declare const CanvasImageNode: FC<NodeProps<ImageNodeType>>;
-/** Free-form prompt fragment node. */
-export declare const CanvasTextNode: FC<NodeProps<TextNodeType>>;
-/** Generation config form; incoming edges contribute prompt text and reference images. */
-export declare const CanvasConfigNode: FC<NodeProps<ConfigNodeType>>;
-export declare const canvasNodeTypes: {
-    readonly image: FC<NodeProps<ImageNodeType>>;
-    readonly text: FC<NodeProps<TextNodeType>>;
-    readonly config: FC<NodeProps<ConfigNodeType>>;
-};
-export {};

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

@@ -1,29 +0,0 @@
-/**
- * IndexedDB persistence for the canvas workspace plus the cross-view import
- * bridge: conversation image cards enqueue pending imports, the canvas tab
- * drains them (live when open, on mount otherwise). Mirrors gallery-store's
- * schemaless pattern so optional fields never need a version bump.
- */
-import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
-import type { CanvasDocument } from './canvas-model.js';
-export interface PendingCanvasImport {
-    id: string;
-    attachment: ImageAttachmentRef;
-    prompt?: string;
-    provider?: string;
-    model?: string;
-    createdAt: number;
-    sourceAttachmentIds?: string[];
-}
-export declare function loadCanvasDocument(): Promise<CanvasDocument | undefined>;
-export declare function saveCanvasDocument(doc: CanvasDocument): Promise<void>;
-type CanvasListener = () => void;
-/** Subscribe to pending-import arrivals so an open canvas can drain live. */
-export declare function subscribeCanvas(listener: CanvasListener): () => void;
-/** Enqueue one conversation image for the canvas. Fire-and-forget safe. */
-export declare function enqueuePendingCanvasImport(item: Omit<PendingCanvasImport, 'id' | 'createdAt'> & {
-    createdAt?: number;
-}): Promise<void>;
-/** Read and clear the pending-import queue. */
-export declare function drainPendingCanvasImports(): Promise<PendingCanvasImport[]>;
-export {};

package/lib/types/client/canvas/canvas-style.d.ts

@@ -1 +0,0 @@
-export declare const CANVAS_STYLE: string;

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

@@ -1,8 +0,0 @@
-import { type FC } from 'react';
-import type { LocaleService } from '../gallery-view.js';
-export interface CanvasViewTabProps {
-    locale?: LocaleService;
-    sessionId?: string;
-    useSessions?: (selector: (state: any) => any) => any;
-}
-export declare const CanvasViewTab: FC<CanvasViewTabProps>;

package/lib/types/client/canvas/rf-base-css.d.ts

@@ -1,2 +0,0 @@
-/** Bundled React Flow base styles (@xyflow/react v12, MIT). Generated from dist/style.css - do not edit by hand. */
-export declare const RF_BASE_CSS: string;

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

@@ -1,23 +0,0 @@
-/**
- * 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/tl/diagram-landing.d.ts

@@ -1,75 +0,0 @@
-/**
- * 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

@@ -1,76 +0,0 @@
-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

@@ -1,40 +0,0 @@
-/**
- * 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/diagram.d.ts

@@ -1,42 +0,0 @@
-/**
- * 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;