dsh-image-gen 0.1.7 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. package/README.en.md +13 -9
  2. package/README.md +29 -18
  3. package/README.zh-CN.md +5 -4
  4. package/lib/client.js +6 -1
  5. package/lib/client.js.map +1 -1
  6. package/lib/index.js +727 -195
  7. package/lib/types/dashscope.d.ts +12 -3
  8. package/lib/types/google.d.ts +14 -3
  9. package/lib/types/index.d.ts +0 -3
  10. package/lib/types/openai-compatible.d.ts +15 -3
  11. package/lib/types/reference-image.d.ts +55 -0
  12. package/lib/types/seedream.d.ts +17 -0
  13. package/lib/types/shared.d.ts +1 -1
  14. package/package.json +131 -128
package/lib/types/dashscope.d.ts CHANGED
@@ -1,5 +1,5 @@
1
- /** DashScope (Aliyun Wanx & Qwen-Image) image-generation protocol adapter. */
2
- import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
1
+ /** DashScope Qwen Image generation and editing adapter. */
2
+ import type { ImageAttachmentRef, ImageMediaType } from '@deepseek-ai/dsh-attachment';
3
3
  export interface DashScopeImageOptions {
4
4
  apiKey: string;
5
5
  endpoint: string;
@@ -9,8 +9,17 @@ export interface DashScopeImageOptions {
9
9
  maxBytes: number;
10
10
  signal?: AbortSignal;
11
11
  }
12
- /** Call DashScope image synthesis/generation API and handle both synchronous output & async task polling. */
12
+ export interface DashScopeEditOptions extends DashScopeImageOptions {
13
+ sourceImages: Array<{
14
+ data: Uint8Array;
15
+ mediaType: ImageMediaType;
16
+ }>;
17
+ }
13
18
  export declare function generateDashScopeImage(options: DashScopeImageOptions): Promise<{
14
19
  data: Uint8Array;
15
20
  mediaType: ImageAttachmentRef['mediaType'];
16
21
  }>;
22
+ export declare function editDashScopeImage(options: DashScopeEditOptions): Promise<{
23
+ data: Uint8Array;
24
+ mediaType: ImageAttachmentRef['mediaType'];
25
+ }>;
package/lib/types/google.d.ts CHANGED
@@ -6,14 +6,25 @@ export interface GeneratedImage {
6
6
  data: Uint8Array;
7
7
  mediaType: ImageMediaType;
8
8
  }
9
- /** Send one native Google image request and validate its inline image response. */
10
- export declare function generateGoogleImage(input: {
9
+ interface GoogleRequestBase {
11
10
  apiKey: string;
12
11
  endpoint: string;
13
12
  model: string;
14
- prompt: string;
15
13
  aspectRatio: AspectRatio;
16
14
  imageSize: ImageSize;
17
15
  maxBytes: number;
18
16
  signal: AbortSignal;
17
+ }
18
+ /** Send one native Google text-to-image request. */
19
+ export declare function generateGoogleImage(input: GoogleRequestBase & {
20
+ prompt: string;
21
+ }): Promise<GeneratedImage>;
22
+ /** Send one native Google image-editing request using already-resolved bytes. */
23
+ export declare function editGoogleImage(input: GoogleRequestBase & {
24
+ prompt: string;
25
+ sourceImages: Array<{
26
+ data: Uint8Array;
27
+ mediaType: ImageMediaType;
28
+ }>;
19
29
  }): Promise<GeneratedImage>;
30
+ export {};
package/lib/types/index.d.ts CHANGED
@@ -3,9 +3,6 @@ import type { Context } from '@deepseek-ai/cordis';
3
3
  import { Config } from './config.js';
4
4
  export { Config } from './config.js';
5
5
  export { IMAGE_ROUTE, imageAttachmentFromMeta } from './image-route.js';
6
- /** Cordis plugin name. */
7
6
  export declare const name = "dsh-image-gen";
8
- /** Host services required by the Bundle. */
9
7
  export declare const inject: string[];
10
- /** Register settings, the image route, and the model-callable tool. */
11
8
  export declare function apply(ctx: Context, config?: Config): void;
package/lib/types/openai-compatible.d.ts CHANGED
@@ -1,11 +1,13 @@
1
- /** OpenAI Images API and Volcengine Ark/Seedream response adapter. */
1
+ /** OpenAI Images API and compatible response adapter. */
2
2
  import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
3
- /** One generated raster normalized before Attachment persistence. */
4
3
  export interface GeneratedCompatibleImage {
5
4
  data: Uint8Array;
6
5
  mediaType: ImageMediaType;
7
6
  }
8
- /** Generate an image from an OpenAI-compatible endpoint. */
7
+ export interface CompatibleReferenceImage {
8
+ data: Uint8Array;
9
+ mediaType: ImageMediaType;
10
+ }
9
11
  export declare function generateOpenAICompatibleImage(input: {
10
12
  provider: 'openai' | 'seedream';
11
13
  apiKey: string;
@@ -16,3 +18,13 @@ export declare function generateOpenAICompatibleImage(input: {
16
18
  maxBytes: number;
17
19
  signal: AbortSignal;
18
20
  }): Promise<GeneratedCompatibleImage>;
21
+ export declare function editOpenAICompatibleImage(input: {
22
+ apiKey: string;
23
+ baseURL: string;
24
+ model: string;
25
+ prompt: string;
26
+ sourceImages: CompatibleReferenceImage[];
27
+ size?: string;
28
+ maxBytes: number;
29
+ signal: AbortSignal;
30
+ }): Promise<GeneratedCompatibleImage>;
package/lib/types/reference-image.d.ts ADDED
@@ -0,0 +1,55 @@
1
+ import type { ImageAttachmentRef, ImageMediaType, StoredImageAttachment } from '@deepseek-ai/dsh-attachment';
2
+ import type { Message } from '@deepseek-ai/dsh-llm';
3
+ /** Provider-neutral image bytes passed across the DSH/provider boundary. */
4
+ export interface ResolvedReferenceImage {
5
+ data: Uint8Array;
6
+ mediaType: ImageMediaType;
7
+ }
8
+ /** The small latest-DSH session surface this Bundle depends on. */
9
+ export interface ReferenceImageAgent {
10
+ session: {
11
+ deriveMessages(): readonly Message[];
12
+ header?: {
13
+ cwd?: string;
14
+ };
15
+ };
16
+ }
17
+ /** The small latest-DSH attachment surface this Bundle depends on. */
18
+ export interface ReferenceImageStore {
19
+ readImage(ref: ImageAttachmentRef, signal?: AbortSignal): Promise<StoredImageAttachment>;
20
+ }
21
+ /**
22
+ * Resolve and read the image to edit from the current effective conversation.
23
+ *
24
+ * This is the only module allowed to know how DSH sessions expose effective
25
+ * messages or how nested model-facing content stores durable image refs.
26
+ */
27
+ export declare function resolveReferenceImage(input: {
28
+ agent?: ReferenceImageAgent;
29
+ attachments: ReferenceImageStore;
30
+ sourceAttachmentId?: string;
31
+ sourcePath?: string;
32
+ maxBytes?: number;
33
+ signal: AbortSignal;
34
+ }): Promise<ResolvedReferenceImage>;
35
+ /**
36
+ * Resolve one or more edit references while keeping every DSH-specific detail
37
+ * behind this compatibility boundary. Explicit selectors preserve caller order;
38
+ * without selectors, all images in the newest image-bearing message are used.
39
+ */
40
+ export declare function resolveReferenceImages(input: {
41
+ agent?: ReferenceImageAgent;
42
+ attachments: ReferenceImageStore;
43
+ sourceAttachmentId?: string;
44
+ sourceAttachmentIds?: readonly string[];
45
+ sourcePath?: string;
46
+ sourcePaths?: readonly string[];
47
+ maxBytes?: number;
48
+ signal: AbortSignal;
49
+ }): Promise<ResolvedReferenceImage[]>;
50
+ /** Find images in caller order, or every image in the newest image-bearing message. */
51
+ export declare function findReferenceImages(messages: readonly Message[], sourceAttachmentIds?: readonly string[]): ImageAttachmentRef[];
52
+ /** Find the newest matching image in the effective, replacement-aware history. */
53
+ export declare function findReferenceImage(messages: readonly Message[], sourceAttachmentId?: string): ImageAttachmentRef | undefined;
54
+ /** Validate an untrusted serialized image reference at an HTTP/UI boundary. */
55
+ export declare function parseImageAttachmentRef(value: unknown): ImageAttachmentRef | undefined;
package/lib/types/seedream.d.ts ADDED
@@ -0,0 +1,17 @@
1
+ /** Volcengine Ark Seedream image-editing adapter. */
2
+ import type { ImageMediaType } from '@deepseek-ai/dsh-attachment';
3
+ import type { GeneratedCompatibleImage } from './openai-compatible.js';
4
+ /** Edit one image through Ark ImageGenerations using a data-URL reference. */
5
+ export declare function editSeedreamImage(input: {
6
+ apiKey: string;
7
+ baseURL: string;
8
+ model: string;
9
+ prompt: string;
10
+ sourceImages: Array<{
11
+ data: Uint8Array;
12
+ mediaType: ImageMediaType;
13
+ }>;
14
+ size?: string;
15
+ maxBytes: number;
16
+ signal: AbortSignal;
17
+ }): Promise<GeneratedCompatibleImage>;
package/lib/types/shared.d.ts CHANGED
@@ -15,6 +15,6 @@ export declare const DEFAULT_DASHSCOPE_ENDPOINT = "https://dashscope.aliyuncs.co
15
15
  export declare const DEFAULT_GOOGLE_MODEL = "gemini-3.1-flash-image";
16
16
  export declare const DEFAULT_OPENAI_MODEL = "gpt-image-2";
17
17
  export declare const DEFAULT_SEEDREAM_MODEL = "doubao-seedream-5-0-260128";
18
- export declare const DEFAULT_DASHSCOPE_MODEL = "wanx2.1-t2i-turbo";
18
+ export declare const DEFAULT_DASHSCOPE_MODEL = "qwen-image-3.0";
19
19
  export declare const DEFAULT_MODELS: Record<ImageProvider, string>;
20
20
  export declare const DEFAULT_BASE_URLS: Record<ImageProvider, string>;
package/package.json CHANGED
@@ -1,128 +1,131 @@
1
- {
2
- "name": "dsh-image-gen",
3
- "version": "0.1.7",
4
- "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope & more.",
5
- "type": "module",
6
- "author": "shanliuling",
7
- "repository": {
8
- "type": "git",
9
- "url": "git+https://github.com/shanliuling/dsh-image-gen.git"
10
- },
11
- "bugs": {
12
- "url": "https://github.com/shanliuling/dsh-image-gen/issues"
13
- },
14
- "homepage": "https://github.com/shanliuling/dsh-image-gen#readme",
15
- "main": "lib/index.js",
16
- "types": "lib/types/index.d.ts",
17
- "exports": {
18
- ".": {
19
- "types": "./lib/types/index.d.ts",
20
- "default": "./lib/index.js"
21
- },
22
- "./client": {
23
- "types": "./lib/types/client/index.d.ts",
24
- "default": "./lib/client.js"
25
- },
26
- "./package.json": "./package.json"
27
- },
28
- "files": [
29
- "lib/index.js",
30
- "lib/client.js",
31
- "lib/client.js.map",
32
- "lib/types/**/*.d.ts",
33
- "skills/**/*.md",
34
- "cordis.patch.yml",
35
- "README.md",
36
- "README.zh-CN.md",
37
- "LICENSE"
38
- ],
39
- "dsh": {
40
- "bundle": {
41
- "patch": "./cordis.patch.yml"
42
- },
43
- "client": {
44
- "inject": [
45
- "@deepseek-ai/dsh-client-connection",
46
- "@deepseek-ai/dsh-api-remotes",
47
- "@deepseek-ai/dsh-client-runtime",
48
- "@deepseek-ai/dsh-client-ui-conversation",
49
- "@deepseek-ai/dsh-client-ui-settings",
50
- "@deepseek-ai/dsh-client-ui-settings-plugins",
51
- "@deepseek-ai/dsh-client-ui-tool",
52
- "@deepseek-ai/dsh-client-locale"
53
- ],
54
- "platform": "web"
55
- }
56
- },
57
- "engines": {
58
- "node": "^22.19.0 || >=24.0.0"
59
- },
60
- "license": "MIT",
61
- "keywords": [
62
- "deepseek",
63
- "deepseek-harness",
64
- "dsh",
65
- "dsh-plugin",
66
- "ai-agent",
67
- "image-generation",
68
- "ai-image-generation",
69
- "multimodal",
70
- "gemini",
71
- "openai",
72
- "openai-compatible",
73
- "seedream",
74
- "dashscope",
75
- "wanx",
76
- "aliyun",
77
- "volcengine",
78
- "byok",
79
- "cordis"
80
- ],
81
- "peerDependencies": {
82
- "@deepseek-ai/cordis": ">=4.0.0 <5",
83
- "@deepseek-ai/dsh-attachment": ">=0.1.0-rc.5 <0.2.0",
84
- "@deepseek-ai/dsh-api-remotes": ">=0.1.0-rc.5 <0.2.0",
85
- "@deepseek-ai/dsh-client-connection": ">=0.1.0-rc.5 <0.2.0",
86
- "@deepseek-ai/dsh-client-runtime": ">=0.1.0-rc.5 <0.2.0",
87
- "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.0-rc.5 <0.2.0",
88
- "@deepseek-ai/dsh-client-ui-settings": ">=0.1.0-rc.5 <0.2.0",
89
- "@deepseek-ai/dsh-client-ui-settings-plugins": ">=0.1.0-rc.5 <0.2.0",
90
- "@deepseek-ai/dsh-client-ui-slots": ">=0.1.0-rc.5 <0.2.0",
91
- "@deepseek-ai/dsh-client-ui-tool": ">=0.1.0-rc.5 <0.2.0",
92
- "@deepseek-ai/dsh-credentials": ">=0.1.0-rc.5 <0.2.0",
93
- "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.5 <0.2.0",
94
- "@deepseek-ai/dsh-settings": ">=0.1.0-rc.5 <0.2.0",
95
- "@deepseek-ai/dsh-tools": ">=0.1.0-rc.5 <0.2.0",
96
- "@deepseek-ai/schemastery": ">=3.18.0 <4",
97
- "react": ">=18.2.0 <19"
98
- },
99
- "devDependencies": {
100
- "@deepseek-ai/cordis": "4.0.1",
101
- "@deepseek-ai/dsh-attachment": "0.1.0-rc.6",
102
- "@deepseek-ai/dsh-api-remotes": "0.1.0-rc.6",
103
- "@deepseek-ai/dsh-client-connection": "0.1.0-rc.6",
104
- "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
105
- "@deepseek-ai/dsh-client-ui-conversation": "0.1.0-rc.6",
106
- "@deepseek-ai/dsh-client-ui-settings": "0.1.0-rc.6",
107
- "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.0-rc.6",
108
- "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
109
- "@deepseek-ai/dsh-client-ui-tool": "0.1.0-rc.6",
110
- "@deepseek-ai/dsh-credentials": "0.1.0-rc.6",
111
- "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.6",
112
- "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
113
- "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
114
- "@deepseek-ai/schemastery": "3.18.1",
115
- "@types/node": "^22.20.0",
116
- "@types/react": "~18.3.1",
117
- "react": "^18.2.0",
118
- "tsdown": "^0.22.2",
119
- "typescript": "^6.0.3",
120
- "vitest": "^4.1.8"
121
- },
122
- "scripts": {
123
- "typecheck": "tsc --noEmit",
124
- "build": "tsc && tsdown",
125
- "test": "vitest run",
126
- "pack:check": "pnpm pack --dry-run"
127
- }
128
- }
1
+ {
2
+ "name": "dsh-image-gen",
3
+ "version": "0.2.1",
4
+ "description": "Bring ChatGPT-like image generation to DeepSeek Harness — Gemini, OpenAI, Seedream, DashScope & more.",
5
+ "type": "module",
6
+ "author": "shanliuling",
7
+ "repository": {
8
+ "type": "git",
9
+ "url": "git+https://github.com/shanliuling/dsh-image-gen.git"
10
+ },
11
+ "bugs": {
12
+ "url": "https://github.com/shanliuling/dsh-image-gen/issues"
13
+ },
14
+ "homepage": "https://github.com/shanliuling/dsh-image-gen#readme",
15
+ "main": "lib/index.js",
16
+ "types": "lib/types/index.d.ts",
17
+ "exports": {
18
+ ".": {
19
+ "types": "./lib/types/index.d.ts",
20
+ "default": "./lib/index.js"
21
+ },
22
+ "./client": {
23
+ "types": "./lib/types/client/index.d.ts",
24
+ "default": "./lib/client.js"
25
+ },
26
+ "./package.json": "./package.json"
27
+ },
28
+ "files": [
29
+ "lib/index.js",
30
+ "lib/client.js",
31
+ "lib/client.js.map",
32
+ "lib/types/**/*.d.ts",
33
+ "skills/**/*.md",
34
+ "cordis.patch.yml",
35
+ "README.md",
36
+ "README.zh-CN.md",
37
+ "LICENSE"
38
+ ],
39
+ "dsh": {
40
+ "bundle": {
41
+ "patch": "./cordis.patch.yml"
42
+ },
43
+ "client": {
44
+ "inject": [
45
+ "@deepseek-ai/dsh-client-connection",
46
+ "@deepseek-ai/dsh-api-remotes",
47
+ "@deepseek-ai/dsh-client-runtime",
48
+ "@deepseek-ai/dsh-client-ui-conversation",
49
+ "@deepseek-ai/dsh-client-ui-settings",
50
+ "@deepseek-ai/dsh-client-ui-settings-plugins",
51
+ "@deepseek-ai/dsh-client-ui-tool",
52
+ "@deepseek-ai/dsh-client-locale"
53
+ ],
54
+ "platform": "web"
55
+ }
56
+ },
57
+ "scripts": {
58
+ "typecheck": "tsc --noEmit",
59
+ "build": "tsc && tsdown",
60
+ "prepare": "pnpm run build",
61
+ "test": "vitest run",
62
+ "pack:check": "pnpm pack --dry-run"
63
+ },
64
+ "engines": {
65
+ "node": "^22.19.0 || >=24.0.0"
66
+ },
67
+ "license": "MIT",
68
+ "keywords": [
69
+ "deepseek",
70
+ "deepseek-harness",
71
+ "dsh",
72
+ "dsh-plugin",
73
+ "ai-agent",
74
+ "image-generation",
75
+ "ai-image-generation",
76
+ "multimodal",
77
+ "gemini",
78
+ "openai",
79
+ "openai-compatible",
80
+ "seedream",
81
+ "dashscope",
82
+ "wanx",
83
+ "aliyun",
84
+ "volcengine",
85
+ "byok",
86
+ "cordis"
87
+ ],
88
+ "peerDependencies": {
89
+ "@deepseek-ai/cordis": ">=4.0.0 <5",
90
+ "@deepseek-ai/dsh-api-remotes": ">=0.1.1-rc.2 <0.2.0",
91
+ "@deepseek-ai/dsh-attachment": ">=0.1.1-rc.2 <0.2.0",
92
+ "@deepseek-ai/dsh-client-connection": ">=0.1.1-rc.2 <0.2.0",
93
+ "@deepseek-ai/dsh-client-runtime": ">=0.1.1-rc.2 <0.2.0",
94
+ "@deepseek-ai/dsh-client-ui-conversation": ">=0.1.1-rc.2 <0.2.0",
95
+ "@deepseek-ai/dsh-client-ui-settings": ">=0.1.1-rc.2 <0.2.0",
96
+ "@deepseek-ai/dsh-client-ui-settings-plugins": ">=0.1.1-rc.2 <0.2.0",
97
+ "@deepseek-ai/dsh-client-ui-slots": ">=0.1.1-rc.2 <0.2.0",
98
+ "@deepseek-ai/dsh-client-ui-tool": ">=0.1.1-rc.2 <0.2.0",
99
+ "@deepseek-ai/dsh-credentials": ">=0.1.1-rc.2 <0.2.0",
100
+ "@deepseek-ai/dsh-host-webserver": ">=0.1.1-rc.2 <0.2.0",
101
+ "@deepseek-ai/dsh-settings": ">=0.1.1-rc.2 <0.2.0",
102
+ "@deepseek-ai/dsh-tools": ">=0.1.1-rc.2 <0.2.0",
103
+ "@deepseek-ai/schemastery": ">=3.18.0 <4",
104
+ "react": ">=18.2.0 <19"
105
+ },
106
+ "devDependencies": {
107
+ "@deepseek-ai/cordis": "4.0.1",
108
+ "@deepseek-ai/dsh-api-remotes": "0.1.1-rc.2",
109
+ "@deepseek-ai/dsh-attachment": "0.1.1-rc.2",
110
+ "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
111
+ "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2",
112
+ "@deepseek-ai/dsh-client-ui-conversation": "0.1.1-rc.2",
113
+ "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2",
114
+ "@deepseek-ai/dsh-client-ui-settings-plugins": "0.1.1-rc.2",
115
+ "@deepseek-ai/dsh-client-ui-slots": "0.1.1-rc.2",
116
+ "@deepseek-ai/dsh-client-ui-tool": "0.1.1-rc.2",
117
+ "@deepseek-ai/dsh-credentials": "0.1.1-rc.2",
118
+ "@deepseek-ai/dsh-host-webserver": "0.1.1-rc.2",
119
+ "@deepseek-ai/dsh-llm": "0.1.1-rc.2",
120
+ "@deepseek-ai/dsh-settings": "0.1.1-rc.2",
121
+ "@deepseek-ai/dsh-tools": "0.1.1-rc.2",
122
+ "@deepseek-ai/schemastery": "3.18.1",
123
+ "@types/node": "^22.20.0",
124
+ "@types/react": "~18.3.1",
125
+ "react": "^18.2.0",
126
+ "tsdown": "^0.22.2",
127
+ "typescript": "^6.0.3",
128
+ "vitest": "^4.1.8"
129
+ },
130
+ "packageManager": "pnpm@11.7.0"
131
+ }