@tachu/extensions 1.0.0-alpha.1

package/dist/providers/qwen.d.ts

@@ -0,0 +1,145 @@
+import { type ChatRequest, type ChatResponse, type ChatStreamChunk, type Message, type ModelInfo, type ProviderAdapter } from "@tachu/core";
+/**
+ * 万相 / 通义千问图像系列扩展参数（通过 {@link ChatRequest} 运行时强转传入）。
+ *
+ * 典型：
+ * ```ts
+ * const res = await adapter.chat(
+ *   { ...request, qwenImage: { size: "2048*2048", n: 1, watermark: false } } as QwenChatRequest,
+ * );
+ * ```
+ *
+ * 三条生图路径共享本结构，按模型归属各取所需：
+ *   1. `wanx-*`（异步 `text2image/image-synthesis`）—— 仅使用基础参数 + `refImage*`
+ *   2. `wan2.x-image*`（同步 `multimodal-generation/generation`）—— 支持 `watermark` /
+ *      `promptExtend` / `seed` / 2K `size` / `refImages[]` 等
+ *   3. `qwen-image-*`（OpenAI 兼容 chat）—— 走 `messages.content = text[]` 格式
+ */
+export interface QwenImageParameters {
+    negativePrompt?: string;
+    size?: string;
+    n?: number;
+    style?: string;
+    seed?: number;
+    /** 参考图 URL（与消息内 `image_url` 二选一，显式字段优先） */
+    refImage?: string;
+    refStrength?: number;
+    refMode?: "repaint" | "refonly";
+    /** 多参考图（wan2.x-image 同步端点支持；为空时回退到 refImage / 消息内 image） */
+    refImages?: string[];
+    /** wan2.x-image：是否叠加 DashScope 水印。默认由服务端决定 */
+    watermark?: boolean;
+    /** wan2.x-image：开启 LLM 深度思考再生图 */
+    thinkingMode?: boolean;
+    /** wan2.x-image：是否用 LLM 重写 / 扩展 prompt */
+    promptExtend?: boolean;
+    /** wan2.x-image：开启分镜连贯生成（同一批多图剧情一致） */
+    enableSequential?: boolean;
+    /** wan2.x-image：布局约束框（相对 0..1） */
+    bboxList?: Array<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+    /** wan2.x-image：目标色板（hex）。超出 8 个服务端可能截断 */
+    colorPalette?: string[];
+    /** wan2.x-image：输出格式，默认服务端选 png */
+    outputFormat?: "png" | "jpeg" | "webp";
+}
+export type QwenChatRequest = ChatRequest & {
+    qwenImage?: QwenImageParameters;
+};
+interface QwenProviderOptions {
+    apiKey?: string;
+    /**
+     * DashScope OpenAI 兼容接口根路径（不含尾部 `/`）。
+     * 默认：`https://dashscope.aliyuncs.com/compatible-mode/v1`
+     */
+    compatibleBaseUrl?: string;
+    /**
+     * DashScope 网关根（不含路径），用于文生图异步 API 与任务查询。
+     * 北京：`https://dashscope.aliyuncs.com`
+     * 国际：`https://dashscope-intl.aliyuncs.com`
+     */
+    dashScopeOrigin?: string;
+    /** RAM 子账号等场景下的百炼业务空间 ID，映射请求头 `X-DashScope-WorkSpace` */
+    workspaceId?: string;
+    timeoutMs?: number;
+    /** 文生图任务轮询间隔（ms） */
+    imageTaskPollIntervalMs?: number;
+    modelListCacheTtlMs?: number;
+    /**
+     * 透传给内部 {@link OpenAI} 客户端构造器（与 OpenAI Provider 一致）。
+     */
+    extra?: Record<string, unknown>;
+}
+/**
+ * 将 string 形式的 `content` 转为 `[{ type: "text", text }]`，满足 DashScope 对生图类 chat 的校验。
+ */
+export declare const coerceStringContentToTextPartsForDashScopeQwenImage: (model: string, messages: Message[]) => Message[];
+/**
+ * 百炼 OpenAI 兼容接口对部分模型不接受独立 `system` 行，且要求 `messages[0].role` 为 `user`、
+ * 多模态时 `content` 为合法 list，典型 400：`Input should be 'user': input.messages.0.role`。
+ *
+ * 将 system 前缀合并进**最后一条 user**（引擎里即本轮当前输入；含多模态块时并入其文本前缀），
+ * 与 Intent / direct-answer / tool-use 组装顺序一致：`[system, ...history, lastUser]`。
+ *
+ * @see https://help.aliyun.com/zh/dashscope/developer-reference/compatibility-of-openai-with-dashscope
+ */
+export declare const mergeSystemIntoLastUserForDashScope: (messages: Message[]) => Message[];
+/**
+ * 阿里云百炼 Qwen / 万相（DashScope）Provider。
+ *
+ * - 文本与多模态对话：OpenAI 兼容接口 `compatible-mode/v1`（与官方示例一致）。
+ * - 文生图：`wanx-*` 模型走异步 `text2image/image-synthesis` + `tasks` 轮询（HTTP 仅支持异步）。
+ *
+ * @see https://help.aliyun.com/zh/dashscope/developer-reference/api-details-9
+ */
+export declare class QwenProviderAdapter implements ProviderAdapter {
+    readonly id = "qwen";
+    readonly name = "Qwen (DashScope)";
+    private readonly inner;
+    private readonly apiKey;
+    private readonly dashScopeOrigin;
+    private readonly workspaceId;
+    private readonly timeoutMs;
+    private readonly imageTaskPollIntervalMs;
+    constructor(options?: QwenProviderOptions);
+    listAvailableModels(): Promise<ModelInfo[]>;
+    chat(request: ChatRequest, signal?: AbortSignal): Promise<ChatResponse>;
+    chatStream(request: ChatRequest, signal?: AbortSignal): AsyncIterable<ChatStreamChunk>;
+    countTokens(messages: Message[], model: string): Promise<number>;
+    dispose(): Promise<void>;
+    private chatImageSynthesis;
+    /**
+     * 同步调用 DashScope `POST /api/v1/services/aigc/multimodal-generation/generation`
+     * 为 `wan2.x-image*` 系列提供文生图能力。
+     *
+     * 请求结构：
+     * ```json
+     * {
+     *   "model": "wan2.7-image",
+     *   "input": {
+     *     "messages": [
+     *       {"role": "user", "content": [{"text": "..."}, {"image": "https://..."}]}
+     *     ]
+     *   },
+     *   "parameters": {"size": "2048*2048", "n": 1, "watermark": false}
+     * }
+     * ```
+     *
+     * 响应结构：
+     * ```json
+     * {"output": {"choices": [{"message": {"content": [{"image": "https://..."}]}}]}}
+     * ```
+     *
+     * @see https://help.aliyun.com/zh/model-studio/text-to-image-api-reference
+     */
+    private chatMultimodalGeneration;
+    private buildHeaders;
+    private createImageTask;
+    private pollTaskUntilDone;
+}
+export {};
+//# sourceMappingURL=qwen.d.ts.map

package/dist/providers/qwen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen.d.ts","sourceRoot":"","sources":["../../src/providers/qwen.ts"],"names":[],"mappings":"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"}