dsh-image-gen 0.5.0 → 0.6.0

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

@@ -1,11 +1,6 @@
 import { type FC } from 'react';
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
-export interface LocaleService {
-    subscribe(cb: () => void): () => void;
-    getSnapshot(): {
-        active?: string;
-    };
-}
+import type { LocaleService } from './gallery-view.js';
 export interface StudioReferenceItem {
     id: string;
     attachment?: ImageAttachmentRef;
@@ -22,6 +17,13 @@ export declare const StudioView: FC<{
     locale?: LocaleService | undefined;
     workspace?: StudioWorkspaceProps | null | undefined;
     initialPrompt?: string | undefined;
+    /**
+     * Canvas surface opened first: 'preview' (single-image viewer, the default)
+     * or 'infinite' (the tldraw editor). The right-sidebar variant opens the
+     * infinite canvas directly - mirroring chat-generated images while the
+     * native conversation runs beside it is the point of the split.
+     */
+    initialCanvasSurface?: 'preview' | 'infinite' | undefined;
     onInitialPromptApplied?(): void;
     onOpenInspiration?(): void;
 }>;

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

@@ -0,0 +1,22 @@
+/**
+ * Live canvas-state sync from one tldraw surface to the host mirror.
+ *
+ * The conversation agent runs in the host process and cannot see the browser
+ * canvas, so this module is the canvas's voice: it watches the editor store,
+ * summarizes the page (shape inventory + selection) and pushes a compact
+ * snapshot to the canvas-state route. When the selection settles on content
+ * the conversation cannot already see — hand-drawn strokes, text, pasted
+ * images — it also exports a PNG screenshot of the selection, which the host
+ * turns into a durable attachment (view_canvas / edit_image
+ * source=canvas_selection read exactly that).
+ *
+ * Pushes are fire-and-forget: failures warn in the console and the next
+ * change retries. Duplicate snapshots (e.g. camera pans that change nothing
+ * in the summary) never hit the network.
+ */
+import type { Editor } from 'tldraw';
+/**
+ * Start mirroring one editor into the host canvas-state route.
+ * Returns a disposer that stops listening and marks the instance offline.
+ */
+export declare function startCanvasSync(editor: Editor): () => void;

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

@@ -0,0 +1,2 @@
+import { type FC } from 'react';
+export declare const StudioTlCanvas: FC;

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

@@ -0,0 +1,53 @@
+/**
+ * Landing bus between studio generation results and the tldraw canvases.
+ *
+ * Generation paths (single, multi-image, multi-model comparison, chat tool
+ * cards) push items here; every mounted tldraw surface reconciles against the
+ * full list. More than one canvas can be mounted at once (the conversation-view
+ * gallery tab and the right-sidebar studio tab), so the bus broadcasts instead
+ * of draining: each canvas lands the items its own page does not carry yet
+ * (per-canvas galleryId dedupe) and re-reads on every push. If no canvas is
+ * mounted, items wait in memory and land on the next mount. Nothing here or on
+ * any canvas survives a restart: the tldraw surfaces run without
+ * persistenceKey, so unsaved generations vanish on reload - the gallery
+ * remains the only durable store (save-first philosophy).
+ */
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+export interface TlLandingItem {
+    /** Gallery item id; also used to dedupe shapes via shape.meta.galleryId. */
+    galleryId: string;
+    attachment: ImageAttachmentRef;
+    /**
+     * True when this attachment is part of the current conversation messages
+     * (chat tool results): the host can then resolve its full-resolution
+     * original directly, and a canvas screenshot of it would be redundant.
+     * Form generations never enter the conversation, so their selections must
+     * keep the screenshot fallback — the host has no other way to see them.
+     */
+    fromConversation?: boolean;
+    /**
+     * Generation provenance copied onto the landed shape's meta: the canvas
+     * digest then tells the model how each image was made, so "regenerate this"
+     * or "vary this" reuses the original prompt and model instead of guessing.
+     * All optional; shapes landed from older paths simply carry none.
+     */
+    prompt?: string;
+    provider?: string;
+    model?: string;
+}
+type TlLandingListener = () => void;
+/** Queue freshly generated images for the tldraw canvases. Safe to call anywhere. */
+export declare function pushTlLandings(newItems: readonly TlLandingItem[]): void;
+/**
+ * Read every item landed so far in this browser session.
+ *
+ * The list is the in-memory session-scratch record shared by all canvases:
+ * reading never removes items, so a canvas mounted later (or a second canvas
+ * mounted beside the first) reconciles the same set. The list dies with the
+ * page, which is exactly the "unsaved content does not survive a restart"
+ * semantic the studio canvas keeps.
+ */
+export declare function getTlLandings(): readonly TlLandingItem[];
+/** Subscribe to queue pushes. Returns an unsubscribe function. */
+export declare function subscribeTlLandings(listener: TlLandingListener): () => void;
+export {};

package/lib/types/client/tl/tl-css.d.ts

@@ -0,0 +1,2 @@
+/** Bundled tldraw styles (tldraw 5.3.0, tldraw SDK license; the "Made with tldraw" watermark is part of the licensed default UI). Generated from tldraw/tldraw.css - do not edit by hand. */
+export declare const TL_CSS: string;

package/lib/types/index.d.ts

@@ -6,6 +6,7 @@ export { IMAGE_ROUTE, DELETE_ROUTE, SAVE_WORKSPACE_ROUTE, imageAttachmentFromMet
 export { STUDIO_ROUTE } from './shared.js';
 export { INSPIRATION_ROUTE } from './shared.js';
 export { TEST_CONNECTION_ROUTE } from './shared.js';
+export { CANVAS_STATE_ROUTE } from './shared.js';
 export declare const name = "dsh-image-gen";
 export declare const inject: string[];
 export declare function apply(ctx: Context, config?: Config): void;

package/lib/types/reference-image.d.ts

@@ -53,3 +53,4 @@ export declare function findReferenceImages(messages: readonly Message[], source
 export declare function findReferenceImage(messages: readonly Message[], sourceAttachmentId?: string): ImageAttachmentRef | undefined;
 /** Validate an untrusted serialized image reference at an HTTP/UI boundary. */
 export declare function parseImageAttachmentRef(value: unknown): ImageAttachmentRef | undefined;
+export declare function detectImageMediaType(data: Uint8Array): ImageMediaType | undefined;

package/lib/types/shared.d.ts

@@ -12,6 +12,92 @@ export declare const INSPIRATION_ROUTE = "/plugins/dsh-image-gen/inspiration";
 export declare const SAVE_WORKSPACE_ROUTE = "/plugins/dsh-image-gen/save-workspace";
 /** Browser route the settings card probes provider connectivity through. */
 export declare const TEST_CONNECTION_ROUTE = "/plugins/dsh-image-gen/test";
+/** Browser route the workbench infinite canvas pushes live state through. */
+export declare const CANVAS_STATE_ROUTE = "/plugins/dsh-image-gen/canvas-state";
+/** Coarse model-facing kind of one shape on the workbench infinite canvas. */
+export type CanvasNodeKind = 'image' | 'draw' | 'text' | 'note' | 'geo' | 'arrow' | 'frame' | 'other';
+/** Every accepted canvas node kind, for validating untrusted pushes. */
+export declare const CANVAS_NODE_KINDS: readonly CanvasNodeKind[];
+/**
+ * Cap on the selection identity list: the client trims `selection.items` to
+ * this size and the canvas-state route rejects pushes carrying more, so the
+ * two ends can never drift apart.
+ */
+export declare const CANVAS_MAX_SELECTION_ITEMS = 16;
+/**
+ * Cap on the node inventory: the client trims `nodes` to this size and the
+ * canvas-state route rejects pushes carrying more, so the two ends can never
+ * drift apart. Sized to keep the model-facing digest compact.
+ */
+export declare const CANVAS_MAX_NODES = 48;
+/** Same shared-cap contract as CANVAS_MAX_NODES, for the selection kind list. */
+export declare const CANVAS_MAX_SELECTION_KINDS = 8;
+/**
+ * Cap on the generation prompt copied onto canvas image shapes and into the
+ * model-facing summaries. The landing path truncates to this and the
+ * canvas-state route rejects longer values, so the two ends can never drift.
+ * The gallery keeps the full prompt; this is only the canvas-side digest view.
+ */
+export declare const CANVAS_MAX_PROMPT_CHARS = 120;
+/** One shape on the workbench infinite canvas, summarized for the model. */
+export interface CanvasNodeSummary {
+    kind: CanvasNodeKind;
+    /** Gallery id when the shape is a generated image landed from the bus. */
+    galleryId?: string;
+    /** Conversation attachment id for generated images; edit_image can target it directly. */
+    attachmentId?: string;
+    /** Human-facing label: image name, geo variant, or similar. */
+    name?: string;
+    width?: number;
+    height?: number;
+    /** Short text preview for text-bearing shapes. */
+    text?: string;
+    /**
+     * Truncated generation prompt for landed generated images: the model can
+     * reproduce or precisely vary a canvas image instead of guessing from pixels.
+     */
+    prompt?: string;
+    /** Provider id (e.g. "google") the landed image was generated with. */
+    provider?: string;
+    /** Model (or ComfyUI workflow label) the landed image was generated with. */
+    model?: string;
+}
+/** What is currently selected on the canvas. */
+export interface CanvasSelectionSummary {
+    count: number;
+    kinds: readonly CanvasNodeKind[];
+    /**
+     * Capped identity list of the selected shapes, using the same summary shape
+     * as canvas nodes: the model learns WHICH images or strokes are selected
+     * (name, attachment id, dimensions), not just how many. Without this, two
+     * selections of the same size and kind are indistinguishable.
+     */
+    items?: readonly CanvasNodeSummary[];
+}
+/**
+ * One live state push from a browser tldraw instance of the workbench canvas.
+ * The browser owns the canvas; the host keeps only this compact mirror, so
+ * the conversation agent can reason about (and look at) what the user sees.
+ */
+export interface CanvasStatePush {
+    /** Tldraw editor id; distinguishes simultaneously mounted canvases. */
+    clientInstance: string;
+    /** False on the final push right before a canvas unmounts. */
+    connected: boolean;
+    /** Total shape count on the current page (the node list may be capped). */
+    nodeCount: number;
+    /** Capped shape inventory, capped client-side before transport. */
+    nodes?: readonly CanvasNodeSummary[];
+    selection?: CanvasSelectionSummary;
+    /**
+     * PNG data-URL screenshot of the current selection, pushed whenever a
+     * selection settles. It shows the selection as it looks on the canvas —
+     * including annotations drawn over generated images — so the model sees the
+     * live canvas state, not just the original conversation attachment.
+     */
+    selectionImage?: string;
+    updatedAt: number;
+}
 /** Namespace persisted through DSH Settings. */
 export declare const IMAGE_GENERATION_NAMESPACE = "image-generation";
 /** Supported providers. */

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-image-gen",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope, local ComfyUI & more.",
   "type": "module",
   "author": "shanliuling",
@@ -49,6 +49,7 @@
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-ui-settings-plugins",
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
         "@deepseek-ai/dsh-client-ui-tool",
         "@deepseek-ai/dsh-client-locale"
       ],
@@ -99,30 +100,36 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-attachment": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-tool": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-credentials": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-host-webserver": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
+    "@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",
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
+    "react-dom": "18.3.1",
     "tsdown": "^0.22.2",
     "typescript": "^6.0.3",
     "unrun": "^0.3.1",
     "vitest": "^4.1.8"
   },
   "dependencies": {
-    "lucide-react": "^1.38.0"
+    "lucide-react": "^1.38.0",
+    "tldraw": "5.3.0"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",

package/skills/install-dsh-image-gen/SKILL.md

@@ -1,22 +1,22 @@
----
-name: install-dsh-image-gen
-description: Install, configure, verify, or remove the dsh-image-gen Bundle in a DeepSeek Harness Web profile. Use when a user wants Google, OpenAI-compatible relay, Seedream, DashScope, or local ComfyUI image generation in DSH, cannot find the Image generation settings card, or needs help testing generate_image.
----
-
-# Install DSH Image Gen
-
-1. Confirm `dsh` runs and record `dsh --version`.
-2. Ask which Web profile to change if the user did not name one. Default to `web` only when that profile already exists.
-3. Install the pinned package or repository spec the user provides:
-
-   ```sh
-   dsh plugin --profile <profile> add <package-or-git-spec>
-   ```
-
-4. If pnpm blocks the Git dependency's `prepare` script, explain that the allowance executes repository code during installation. Add only the exact package key pnpm reports to the profile's `pnpm-workspace.yaml`, then retry after the user approves.
-5. Verify `dsh --profile <profile> --dump-config` contains the `dsh-image-gen` layer and `image-gen` row.
-6. Start the profile. If port 3080 is already in use, identify the existing DSH process before stopping anything.
-7. In Settings > Plugins > Plugin configuration > Image generation, select a cloud Provider and save its API key, or select Local ComfyUI, enter its URL, and import a ComfyUI API Format workflow JSON containing `{{prompt}}`. Never print, read back, or commit a key.
-8. Test with “生成一张戴墨镜的赛博朋克猫图片”. Confirm one `generate_image` call succeeds and its image renders in the conversation.
-
-For removal, run `dsh plugin --profile <profile> remove dsh-image-gen`. Do not delete the user's credentials unless they explicitly request it.
+---
+name: install-dsh-image-gen
+description: Install, configure, verify, or remove the dsh-image-gen Bundle in a DeepSeek Harness Web profile. Use when a user wants Google, OpenAI-compatible relay, Seedream, DashScope, or local ComfyUI image generation in DSH, cannot find the Image generation settings card, or needs help testing generate_image.
+---
+
+# Install DSH Image Gen
+
+1. Confirm `dsh` runs and record `dsh --version`.
+2. Ask which Web profile to change if the user did not name one. Default to `web` only when that profile already exists.
+3. Install the pinned package or repository spec the user provides:
+
+   ```sh
+   dsh plugin --profile <profile> add <package-or-git-spec>
+   ```
+
+4. If pnpm blocks the Git dependency's `prepare` script, explain that the allowance executes repository code during installation. Add only the exact package key pnpm reports to the profile's `pnpm-workspace.yaml`, then retry after the user approves.
+5. Verify `dsh --profile <profile> --dump-config` contains the `dsh-image-gen` layer and `image-gen` row.
+6. Start the profile. If port 3080 is already in use, identify the existing DSH process before stopping anything.
+7. In Settings > Plugins > Plugin configuration > Image generation, select a cloud Provider and save its API key, or select Local ComfyUI, enter its URL, and import a ComfyUI API Format workflow JSON containing `{{prompt}}`. Never print, read back, or commit a key.
+8. Test with “生成一张戴墨镜的赛博朋克猫图片”. Confirm one `generate_image` call succeeds and its image renders in the conversation.
+
+For removal, run `dsh plugin --profile <profile> remove dsh-image-gen`. Do not delete the user's credentials unless they explicitly request it.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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