@tachu/extensions 1.0.0-beta.1 → 1.0.0-rc.0

package/dist/providers/qwen.d.ts

@@ -0,0 +1,146 @@
+import { type AdapterCallContext, type ChatRequest, type ChatResponse, type ChatStreamChunk, type EmbeddingRequest, type EmbeddingResponse, 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, ctx: AdapterCallContext, signal?: AbortSignal): Promise<ChatResponse>;
+    embed(request: EmbeddingRequest, ctx: AdapterCallContext, signal?: AbortSignal): Promise<EmbeddingResponse>;
+    chatStream(request: ChatRequest, ctx: AdapterCallContext, 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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"}