dsh-connect-workbuddy 5.10.0 → 5.11.0

package/lib/{host-heartbeat-_EeM2YDF.js → host-heartbeat-BYdr-pVq.js}

@@ -1,6 +1,6 @@
 import { lstat, mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import { createDecipheriv, createHash, randomBytes, randomUUID } from "node:crypto";
-import { homedir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { dirname, join, resolve, win32 } from "node:path";
 import { execFile, execFileSync } from "node:child_process";
 import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
@@ -1204,18 +1204,43 @@ var WorkBuddyImageError = class extends Error {
 		this.code = code;
 	}
 };
-function asString(value) {
+function asString$1(value) {
 	return typeof value === "string" && value.trim() !== "" ? value : void 0;
 }
 function stringList(value) {
 	if (!Array.isArray(value)) return [];
 	const out = [];
 	for (const item of value) {
-		const text = asString(item);
+		const text = asString$1(item);
 		if (text !== void 0) out.push(text);
 	}
 	return out;
 }
+function asFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+/**
+* 把目录条目上的 `videoGeneration` 读成已知字段的配置对象（图像链路只是搬运，
+* 不解释它）。与 `video-gen.ts` 的 `readVideoGeneration` 必须同形——同一份上游
+* 数据，两个入口不能读出两个答案。缺字段即 undefined，不补默认值。
+*/
+function readVideoGeneration(raw) {
+	if (typeof raw !== "object" || raw === null) return void 0;
+	const record = raw;
+	const resolutions = stringList(record["resolutions"]);
+	const defaultResolution = asString$1(record["defaultResolution"]);
+	const defaultSeconds = asFiniteNumber(record["defaultSeconds"]);
+	const minSeconds = asFiniteNumber(record["minSeconds"]);
+	const maxSeconds = asFiniteNumber(record["maxSeconds"]);
+	const config = {
+		...resolutions.length === 0 ? {} : { resolutions },
+		...defaultResolution === void 0 ? {} : { defaultResolution },
+		...defaultSeconds === void 0 ? {} : { defaultSeconds },
+		...minSeconds === void 0 ? {} : { minSeconds },
+		...maxSeconds === void 0 ? {} : { maxSeconds }
+	};
+	return Object.keys(config).length === 0 ? void 0 : config;
+}
 /**
 * 从产品配置的 `data.models` 里挑出带指定 tag 的媒体模型。
 *
@@ -1233,21 +1258,23 @@ function selectMediaModels(rawModels, tag = IMAGE_TAG_TEXT_TO_IMAGE) {
 	for (const entry of rawModels) {
 		if (typeof entry !== "object" || entry === null) continue;
 		const record = entry;
-		const id = asString(record["id"]);
+		const id = asString$1(record["id"]);
 		if (id === void 0 || seen.has(id)) continue;
 		const tags = stringList(record["tags"]);
 		if (!wanted.some((one) => tags.includes(one))) continue;
 		seen.add(id);
+		const videoGeneration = readVideoGeneration(record["videoGeneration"]);
 		out.push({
 			id,
-			name: asString(record["name"]) ?? id,
-			tags
+			name: asString$1(record["name"]) ?? id,
+			tags,
+			...videoGeneration === void 0 ? {} : { videoGeneration }
 		});
 	}
 	return out;
 }
 /** tag 的人话名字，只用在错误信息里。 */
-function tagLabel(tag) {
+function tagLabel$1(tag) {
 	if (tag === "image-to-image") return "图生图";
 	if (tag === "text-to-image") return "文生图";
 	return tag;
@@ -1265,12 +1292,12 @@ function pickMediaModel(models, requested, tag = IMAGE_TAG_TEXT_TO_IMAGE) {
 		const found = group.find((model) => model.id === requested);
 		if (found === void 0) {
 			const known = group.map((model) => model.id).join(", ");
-			throw new WorkBuddyImageError(`workbuddy image: 目录里没有${tagLabel(tag)}模型「${requested}」。可用：${known === "" ? "（空）" : known}`, "NO_IMAGE_MODEL");
+			throw new WorkBuddyImageError(`workbuddy image: 目录里没有${tagLabel$1(tag)}模型「${requested}」。可用：${known === "" ? "（空）" : known}`, "NO_IMAGE_MODEL");
 		}
 		return found;
 	}
 	const first = group[0];
-	if (first === void 0) throw new WorkBuddyImageError(`workbuddy image: 该区账号的产品配置里没有任何带 ${tag} 标签的模型（${tagLabel(tag)}）。国内区文生图应是 hunyuan-image-alpha、改图是 hunyuan-image-alpha-edit；国际区 hy-image-3.5 同时带这两个标签；一个都没有说明该区目录暂时没有这类模型。`, "NO_IMAGE_MODEL");
+	if (first === void 0) throw new WorkBuddyImageError(`workbuddy image: 该区账号的产品配置里没有任何带 ${tag} 标签的模型（${tagLabel$1(tag)}）。国内区文生图应是 hunyuan-image-alpha、改图是 hunyuan-image-alpha-edit；国际区 hy-image-3.5 同时带这两个标签；一个都没有说明该区目录暂时没有这类模型。`, "NO_IMAGE_MODEL");
 	return first;
 }
 /** 按官方 CLI 的 `buildBaseRequestBody` 分支规则拼请求体。 */
@@ -1379,8 +1406,8 @@ function parseImageResponse(payload) {
 	const envelope = payload;
 	const code = typeof envelope["code"] === "number" ? envelope["code"] : void 0;
 	if (code !== void 0 && code !== 0) {
-		const message = asString(envelope["msg"]) ?? "unknown error";
-		const requestId = asString(envelope["request_id"]);
+		const message = asString$1(envelope["msg"]) ?? "unknown error";
+		const requestId = asString$1(envelope["request_id"]);
 		throw new WorkBuddyImageError(`workbuddy image: 上游拒绝（code ${code}）: ${message}` + (requestId === void 0 ? "" : `（request_id ${requestId}）`), "UPSTREAM");
 	}
 	const data = envelope["data"];
@@ -1392,8 +1419,8 @@ function parseImageResponse(payload) {
 	let b64;
 	if (typeof first === "object" && first !== null) {
 		const item = first;
-		url = asString(item["url"]);
-		b64 = asString(item["b64_json"]);
+		url = asString$1(item["url"]);
+		b64 = asString$1(item["b64_json"]);
 	}
 	if (url === void 0 && b64 === void 0) throw new WorkBuddyImageError("workbuddy image: 上游返回成功但 data.data 里既没有 url 也没有 b64_json", "EMPTY_RESULT");
 	const usage = typeof record["usage"] === "object" && record["usage"] !== null ? record["usage"] : {};
@@ -1414,7 +1441,7 @@ function describeImageFailure(status, bodyText) {
 		const parsed = JSON.parse(text);
 		if (typeof parsed === "object" && parsed !== null) {
 			const record = parsed;
-			const message = asString(record["msg"]);
+			const message = asString$1(record["msg"]);
 			const code = typeof record["code"] === "number" ? record["code"] : void 0;
 			if (message !== void 0) detail = code === void 0 ? message : `code ${code}: ${message}`;
 		}
@@ -1425,6 +1452,284 @@ function describeImageFailure(status, bodyText) {
 	return new WorkBuddyImageError(`workbuddy image: 上游失败（HTTP ${status}）${detail === "" ? "" : `: ${detail}`}`, "UPSTREAM");
 }
 //#endregion
+//#region src/video-gen.ts
+/**
+* WorkBuddy 生视频的纯逻辑层：媒体模型筛选、请求体构造、任务轮询解析、失败描述。
+*
+* 这一层刻意不做任何网络 I/O、不引用宿主的任何包（同 `src/image-gen.ts` 的约定，
+* 见其模块注释里的可达图说明）。`src/upstream.ts` 会静态引用本模块，所以这里
+* 必须保持零外部依赖。
+*
+* 上游契约照抄官方 CLI `codebuddy-lite-wb.mjs` 的 `VideoService`（实测 2026-10-25，
+* 二进制位于 `WorkBuddy/resources/app.asar.unpacked/cli/dist/codebuddy-lite-wb.mjs`）：
+*
+*   submitTask:  POST {endpoint}/v2/videos/generations
+*               body = { prompt, model, seconds, negative_prompt, watermark:true,
+*                        image_url/last_image_url(图生视频时),
+*                        extra_parameters:{ resolution, enable_audio,
+*                                          aspect_ratio(仅文生视频) } }
+*               resp = { code, msg, request_id, data:{ id } }   ← 只是 task id
+*   pollTask:    POST {endpoint}/v2/videos/tasks  { task_id }
+*               轮询直到 data.status === 'completed' | 'failed'
+*               resp = { code, msg, data:{ status, usage?:{credit}, ... } }
+*   download:   GET 每条 data[].url → 写本地 .mp4
+*
+* 与 `ImageService` 的根本区别：视频是**异步任务**，不是一次同步请求。生图
+* `ImageService` 调一次 `generations` 直接拿 URL；视频 `VideoService` 要先
+* `generations` 拿 task id，再 `tasks` 轮询，最后下载。所以本模块把"提交 / 轮询 /
+* 下载"三段拆开，工具层负责把它们串成一条异步流程（`src/video-tool.ts`）。
+*
+* 模型配置来自产品配置里每条媒体模型的 `videoGeneration` 字段：
+*   { resolutions:[...], defaultResolution, defaultSeconds,
+*     minSeconds, maxSeconds }。时长/分辨率要在该模型允许的集合内，否则上游
+*   会拒。这里把"该模型支持哪些值"的读取与校验收进来，工具层只把用户给的值
+*   递进来、拿校验结果。
+*
+* 两个区的视频目录（2026-10-25 实测，`src/upstream.ts` 的 `fetchMediaModels`
+* 注释）：
+*   - 国内区（61 条模型）：`kling-video-v3` 与 `minimax-video-h3` 各带
+*     `text-to-video` + `image-to-video`。
+*   - 国际区（29 条）：`kling-video-v3` 带两种 video tag。
+* 两边目录完全不重叠，所以"以哪个区为准"由工具的 `videoToolRegionOf` 决定
+* （默认国内区优先，与 image 工具一致）。
+*
+* @module dsh-connect-workbuddy/video-gen
+*/
+/** 产品配置里「文生视频」模型的标签。 */
+const VIDEO_TAG_TEXT_TO_VIDEO = "text-to-video";
+/** 产品配置里「图生视频」模型的标签。 */
+const VIDEO_TAG_IMAGE_TO_VIDEO = "image-to-video";
+/** 生视频路由（提交任务，拿 task id）。 */
+const VIDEO_GENERATIONS_PATH = "/v2/videos/generations";
+/** 任务轮询路由。 */
+const VIDEO_TASKS_PATH = "/v2/videos/tasks";
+/** 支持的非图像决定宽高比集合。 */
+const VIDEO_ASPECT_RATIOS = [
+	"16:9",
+	"9:16",
+	"1:1"
+];
+/** 生视频链路的错误。带一个稳定的 `code`，避免调用方去匹配文案。 */
+var WorkBuddyVideoError = class extends Error {
+	code;
+	constructor(message, code) {
+		super(message);
+		this.name = "WorkBuddyVideoError";
+		this.code = code;
+	}
+};
+function asString(value) {
+	return typeof value === "string" && value.trim() !== "" ? value : void 0;
+}
+/**
+* 从上游的拒绝文案里读出它自己报的时长区间。
+*
+* 目录没有 `videoGeneration` 时，本地无从校验，只能让上游先拒一次；它会以
+* `unsupported video duration: 1 seconds, supported range: 4-15 seconds` 这种
+* 文案把真相说出来。把这段读出来记到本次进程里，第二次同样的参数就能在本地被拦下，
+* 不再多打一次注定失败的请求。读不出来就返回 undefined（绝不猜）。
+*/
+function parseSupportedSecondsRange(text) {
+	const match = /supported range:\s*(\d+(?:\.\d+)?)\s*(?:-|–|—|~|to)\s*(\d+(?:\.\d+)?)/i.exec(text);
+	if (match === null) return void 0;
+	const minSeconds = Number(match[1]);
+	const maxSeconds = Number(match[2]);
+	if (!Number.isFinite(minSeconds) || !Number.isFinite(maxSeconds)) return void 0;
+	if (minSeconds <= 0 || maxSeconds < minSeconds) return void 0;
+	return {
+		minSeconds,
+		maxSeconds
+	};
+}
+/** tag 的人话名字，只用在错误信息里。 */
+function tagLabel(tag) {
+	if (tag === "image-to-video") return "图生视频";
+	if (tag === "text-to-video") return "文生视频";
+	return tag;
+}
+/**
+* 按能力标签选一个视频模型：先在该标签组内找调用方点名的那个，否则取组内第一个。
+*
+* 与 `image-gen.ts` 的 `pickMediaModel` 完全一致的设计——点名的模型必须在**这一组**
+* 里，写错名字或拿文生视频模型去图生视频都直接报错，而不是把它发上去换一个上游 404。
+*/
+function pickVideoModel(models, requested, tag = VIDEO_TAG_TEXT_TO_VIDEO) {
+	const group = models.filter((model) => model.tags.includes(tag));
+	if (requested !== void 0 && requested !== "") {
+		const found = group.find((model) => model.id === requested);
+		if (found === void 0) {
+			const known = group.map((model) => model.id).join(", ");
+			throw new WorkBuddyVideoError(`workbuddy video: 目录里没有${tagLabel(tag)}模型「${requested}」。可用：${known === "" ? "（空）" : known}`, "NO_VIDEO_MODEL");
+		}
+		return found;
+	}
+	const first = group[0];
+	if (first === void 0) throw new WorkBuddyVideoError(`workbuddy video: 该区账号的产品配置里没有任何带 ${tag} 标签的模型（${tagLabel(tag)}）。国内区文生视频/图生视频是 kling-video-v3、minimax-video-h3；国际区 kling-video-v3 同时带这两个标签；一个都没有说明该区目录暂时没有这类模型。`, "NO_VIDEO_MODEL");
+	return first;
+}
+/**
+* 把一次生视频请求组装成上游 `POST /v2/videos/generations` 的请求体。
+*
+* 完全照抄官方 CLI 的 `submitTask`：`prompt` / `model` / `seconds` /
+* `negative_prompt` / `watermark:true`，图生视频时带 `image_url` 或
+* `last_image_url`，`extra_parameters` 里放 `resolution` / `enable_audio` /
+* 以及仅文生视频的 `aspect_ratio`。
+*
+* `config` 来自该模型的 `videoGeneration` 字段，用于回落默认值与约束校验
+* （见 {@link resolveVideoParams}）。`isImageToVideo` 由调用方（工具层）按
+* "有没有给 image" 唯一决定，与 image 工具"不给 image 就是文生图"的约定一致。
+*/
+function buildVideoBody(request, isImageToVideo) {
+	const body = {
+		prompt: request.prompt,
+		model: request.model,
+		seconds: request.seconds,
+		negative_prompt: request.negativePrompt ?? "",
+		watermark: true
+	};
+	if (request.image !== void 0) body["image_url"] = request.image;
+	if (request.lastImage !== void 0) body["last_image_url"] = request.lastImage;
+	const extra = {
+		resolution: request.resolution,
+		enable_audio: request.enableAudio ?? true
+	};
+	if (!isImageToVideo) extra["aspect_ratio"] = request.aspectRatio ?? "16:9";
+	body["extra_parameters"] = extra;
+	return body;
+}
+/**
+* 校验并回落一次生视频请求的可选参数（时长 / 分辨率 / 宽高比）。
+*
+* 集中处理"该模型支持哪些值"的判断，让工具层只需把用户给的值递进来。
+* 返回：最终要用的 `seconds` / `resolution` / `aspectRatio`（图生视频时
+* `aspectRatio` 为 undefined，因为由输入图决定），以及一条非致命告警列表
+* （例如用户给的分辨率模型不支持、被回落成默认值）。
+*
+* 抛 `WorkBuddyVideoError`('INVALID_ARGS') 的情况：prompt 超长、宽高比非法、
+* 模型不支持自定义时长却给了时长、时长越界。
+*/
+function resolveVideoParams(request, config) {
+	const warnings = [];
+	if ((request.prompt ?? "").length > 2500) throw new WorkBuddyVideoError("workbuddy video: prompt 不能超过 2500 字符。", "INVALID_ARGS");
+	if ((request.negativePrompt?.length ?? 0) > 2500) throw new WorkBuddyVideoError("workbuddy video: negative_prompt 不能超过 2500 字符。", "INVALID_ARGS");
+	const isImageToVideo = request.image !== void 0 || request.lastImage !== void 0;
+	const minSeconds = config?.minSeconds;
+	const maxSeconds = config?.maxSeconds;
+	let seconds = request.seconds ?? config?.defaultSeconds ?? 5;
+	if (request.seconds !== void 0) {
+		if (minSeconds !== void 0 && maxSeconds !== void 0 && (seconds < minSeconds || seconds > maxSeconds)) throw new WorkBuddyVideoError(`workbuddy video: 时长必须在 ${minSeconds} 到 ${maxSeconds} 秒之间（给定 ${seconds}）。`, "INVALID_ARGS");
+	}
+	const resolutions = config?.resolutions ?? [];
+	const defaultResolution = config?.defaultResolution;
+	let resolution = defaultResolution;
+	if (request.resolution !== void 0) {
+		const requested = request.resolution;
+		if (resolutions.length === 0) resolution = requested;
+		else {
+			const matched = resolutions.includes(requested) ? requested : resolutions.find((one) => one.toLowerCase() === requested.toLowerCase());
+			if (matched === void 0) {
+				warnings.push(`resolution ${requested} 不被模型 ${request.model} 支持；改用 ${defaultResolution ?? "上游默认"}`);
+				resolution = defaultResolution;
+			} else resolution = matched;
+		}
+	}
+	let aspectRatio;
+	if (!isImageToVideo) {
+		const ar = request.aspectRatio ?? "16:9";
+		if (!VIDEO_ASPECT_RATIOS.includes(ar)) throw new WorkBuddyVideoError(`workbuddy video: aspect_ratio 只能是 ${VIDEO_ASPECT_RATIOS.join("、")} 之一（给定 ${ar}）。`, "INVALID_ARGS");
+		aspectRatio = ar;
+	}
+	return {
+		seconds,
+		resolution,
+		aspectRatio,
+		warnings
+	};
+}
+/**
+* 解析 `POST /v2/videos/generations` 的响应，取出 task id。
+*
+* 信封是 `{code, msg, request_id, data}`，`code !== 0` 是业务失败（与 HTTP
+* 状态无关）。成功时 `data.id` 是 task id。没有 id 就说不通（上游一定返回 id）。
+*/
+function parseVideoSubmission(payload) {
+	if (typeof payload !== "object" || payload === null) throw new WorkBuddyVideoError("workbuddy video: 上游返回的不是 JSON 对象", "UPSTREAM");
+	const envelope = payload;
+	const code = typeof envelope["code"] === "number" ? envelope["code"] : void 0;
+	if (code !== void 0 && code !== 0) {
+		const message = asString(envelope["msg"]) ?? "unknown error";
+		const requestId = asString(envelope["request_id"]);
+		throw new WorkBuddyVideoError(`workbuddy video: 提交失败（code ${code}）: ${message}` + (requestId === void 0 ? "" : `（request_id ${requestId}）`), "UPSTREAM");
+	}
+	const taskId = asString((typeof envelope["data"] === "object" && envelope["data"] !== null ? envelope["data"] : {})["id"]);
+	if (taskId === void 0) throw new WorkBuddyVideoError("workbuddy video: 上游没返回 task id，无法进入轮询。", "EMPTY_RESULT");
+	return {
+		taskId,
+		warnings: []
+	};
+}
+/**
+* 解析 `POST /v2/videos/tasks` 的轮询响应。
+*
+* 返回当前 `status`，以及（完成态时）成品视频 URL 列表与实扣积分。
+* `status` 不在 `pending/processing/completed/failed` 内的未知字符串，一律
+* 当成"还没好"继续轮询，避免把新状态误判成失败而浪费一次已花钱的任务。
+*/
+function parseVideoTask(payload) {
+	if (typeof payload !== "object" || payload === null) throw new WorkBuddyVideoError("workbuddy video: 轮询响应不是 JSON 对象", "UPSTREAM");
+	const envelope = payload;
+	const code = typeof envelope["code"] === "number" ? envelope["code"] : void 0;
+	if (code !== void 0 && code !== 0) {
+		const message = asString(envelope["msg"]) ?? "unknown error";
+		const requestId = asString(envelope["request_id"]);
+		throw new WorkBuddyVideoError(`workbuddy video: 轮询失败（code ${code}）: ${message}` + (requestId === void 0 ? "" : `（request_id ${requestId}）`), "UPSTREAM");
+	}
+	const data = typeof envelope["data"] === "object" && envelope["data"] !== null ? envelope["data"] : {};
+	const status = asString(data["status"]) ?? "unknown";
+	if (status === "completed") {
+		const items = Array.isArray(data["data"]) ? data["data"] : [];
+		const videos = [];
+		for (const item of items) {
+			if (typeof item !== "object" || item === null) continue;
+			const url = asString(item["url"]);
+			if (url !== void 0) videos.push(url);
+		}
+		const usage = typeof data["usage"] === "object" && data["usage"] !== null ? data["usage"] : {};
+		return {
+			status,
+			videos,
+			credit: typeof usage["credit"] === "number" && Number.isFinite(usage["credit"]) ? usage["credit"] : void 0
+		};
+	}
+	return {
+		status,
+		videos: []
+	};
+}
+/** 把一次非 2xx 的提交/轮询响应翻成带 `code` 的错误，好让上层决定怎么提示。 */
+function describeVideoFailure(status, bodyText, phase = "submit") {
+	const text = bodyText.trim();
+	let detail = text.slice(0, 240);
+	if (text.startsWith("{")) try {
+		const parsed = JSON.parse(text);
+		if (typeof parsed === "object" && parsed !== null) {
+			const record = parsed;
+			const message = asString(record["msg"]);
+			const code = typeof record["code"] === "number" ? record["code"] : void 0;
+			if (message !== void 0) detail = code === void 0 ? message : `code ${code}: ${message}`;
+		}
+	} catch {}
+	const where = phase === "submit" ? "提交生视频任务" : "轮询生视频任务";
+	if (status === 401 || status === 403) return new WorkBuddyVideoError(`workbuddy video: 凭据被上游拒绝（HTTP ${status}），请在插件设置里重新登录 WorkBuddy。${detail === "" ? "" : ` ${detail}`}`, "AUTH");
+	if (status === 429) return new WorkBuddyVideoError(`workbuddy video: 触发上游限流（HTTP 429），稍后再试。${detail === "" ? "" : ` ${detail}`}`, "RATE_LIMIT");
+	if (status === 404) return new WorkBuddyVideoError(`workbuddy video: 上游没有这条生视频路由（HTTP 404）——该区网关没有开放视频接口。${detail === "" ? "" : ` ${detail}`}`, "NO_ROUTE");
+	if (phase === "submit" && status >= 400 && status < 500) {
+		const range = parseSupportedSecondsRange(detail);
+		return new WorkBuddyVideoError(`workbuddy video: 上游拒绝了这次生视频请求（HTTP ${status}），没有创建任务、没有扣积分${range === void 0 ? "" : `；该模型支持的时长是 ${range.minSeconds}-${range.maxSeconds} 秒`}。按下面的提示改参数后可以立刻重试。${detail === "" ? "" : ` ${detail}`}`, "REJECTED");
+	}
+	return new WorkBuddyVideoError(`workbuddy video: ${where}失败（HTTP ${status}）${detail === "" ? "" : `: ${detail}`}`, "UPSTREAM");
+}
+//#endregion
 //#region src/off-thinking.ts
 /**
 * Ids observed to REFUSE `reasoning_effort: "off"` with HTTP 400 despite
@@ -2071,6 +2376,14 @@ const PROBE_TIMEOUT_MS = 1e4;
 * 又不至于让一个卡死的连接占住工具槽位太久。
 */
 const IMAGE_TIMEOUT_MS = 18e4;
+/** 视频提交/轮询的总超时：视频要生成几十秒到几分钟，远大于生图。 */
+const VIDEO_TIMEOUT_MS = 6e5;
+/** 轮询之间的间隔（官方 CLI pollTask 用 5s）。 */
+const VIDEO_POLL_INTERVAL_MS = 5e3;
+/** 单个轮询轮次的上限（与 VIDEO_TIMEOUT_MS 对应，防死循环）。 */
+const VIDEO_POLL_TIMEOUT_MS = 6e5;
+/** 单条视频下载超时（官方 CLI 用 120s）。 */
+const VIDEO_DOWNLOAD_TIMEOUT_MS = 12e4;
 /**
 * Insufficient-credit markers.
 *
@@ -4586,6 +4899,122 @@ var WorkBuddyUpstreamClient = class {
 		}
 		return parseImageResponse(payload);
 	}
+	/**
+	* 发一次生视频请求（提交任务，拿 task id）。
+	*
+	* 端点与请求体照抄官方 CLI 的 `VideoService.submitTask`：`POST /v2/videos/generations`，
+	* 请求体由 `buildVideoBody` 拼（prompt / model / seconds / negative_prompt /
+	* watermark:true / 图生视频时的 image_url / extra_parameters）。响应取
+	* `data.id` 作为 task id 返回，真正的视频要再轮询 `/v2/videos/tasks` 才拿得到。
+	*
+	* 这是一次**花钱**的请求（与生图一样），所以失败分类交给 {@link describeVideoFailure}：
+	* 401/403 提示重新登录、404 提示该区没有视频路由、429 提示限流、其它透传 msg。
+	* HTTP 200 但信封 `code !== 0` 由 {@link parseVideoSubmission} 处理。
+	*/
+	async submitVideo(credential, request, signal) {
+		const isImageToVideo = request.image !== void 0 || request.lastImage !== void 0;
+		const body = buildVideoBody({
+			model: request.model,
+			prompt: request.prompt,
+			seconds: request.seconds,
+			negativePrompt: request.negativePrompt,
+			image: request.image,
+			lastImage: request.lastImage,
+			resolution: request.resolution,
+			aspectRatio: request.aspectRatio,
+			enableAudio: request.enableAudio
+		}, isImageToVideo);
+		const response = await fetch(`${chatBase(credential)}${VIDEO_GENERATIONS_PATH}`, {
+			method: "POST",
+			headers: imageHeaders(credential, this.identity),
+			body: JSON.stringify(body),
+			signal: signal ?? AbortSignal.timeout(VIDEO_TIMEOUT_MS)
+		});
+		const text = await response.text();
+		if (!response.ok) throw describeVideoFailure(response.status, text, "submit");
+		let payload;
+		try {
+			payload = JSON.parse(text);
+		} catch {
+			throw new WorkBuddyVideoError(`workbuddy video: 上游返回的不是 JSON（HTTP ${response.status}）: ${text.slice(0, 200)}`, "UPSTREAM");
+		}
+		return parseVideoSubmission(payload);
+	}
+	/**
+	* 轮询一个生视频任务直到完成或失败。
+	*
+	* `POST /v2/videos/tasks`（请求体 `{ task_id }`），官方 CLI 的 `VideoService.pollTask`
+	* 就是每 5 秒查一次、直到 `status === 'completed' | 'failed'`。这里照搬同样的
+	* 轮询节奏与整体超时（默认 ~600s，远大于生图的 180s，因为视频要生成几十秒到几分钟）。
+	*
+	* 注意：轮询**已经花过钱**（提交那次就扣了），所以轮询期间的网络抖动、超时要
+	* 当成真实失败——调用方据此进冷却。只有"提交那一次"因为参数写错 / 没登录而没
+	* 发出去，才不进冷却（同生图工具的设计）。
+	*/
+	async pollVideoTask(credential, taskId, signal) {
+		const startedAt = Date.now();
+		const ownSignal = signal ?? AbortSignal.timeout(VIDEO_TIMEOUT_MS);
+		const combined = signal === void 0 ? ownSignal : AbortSignal.any([signal, AbortSignal.timeout(VIDEO_TIMEOUT_MS)]);
+		for (;;) {
+			if (combined.aborted) throw new WorkBuddyVideoError("workbuddy video: 轮询被取消或超时。", "POLL_TIMEOUT");
+			if (Date.now() - startedAt > VIDEO_POLL_TIMEOUT_MS) throw new WorkBuddyVideoError(`workbuddy video: 轮询超过 ${VIDEO_POLL_TIMEOUT_MS / 1e3} 秒仍未完成（task ${taskId}）。`, "POLL_TIMEOUT");
+			let payload;
+			try {
+				const response = await fetch(`${chatBase(credential)}${VIDEO_TASKS_PATH}`, {
+					method: "POST",
+					headers: imageHeaders(credential, this.identity),
+					body: JSON.stringify({ task_id: taskId }),
+					signal: combined
+				});
+				const text = await response.text();
+				if (!response.ok) throw describeVideoFailure(response.status, text, "poll");
+				try {
+					payload = JSON.parse(text);
+				} catch {
+					throw new WorkBuddyVideoError(`workbuddy video: 轮询响应不是 JSON（HTTP ${response.status}）: ${text.slice(0, 200)}`, "UPSTREAM");
+				}
+			} catch (error) {
+				if (error instanceof WorkBuddyVideoError) throw error;
+				throw new WorkBuddyVideoError(`workbuddy video: 轮询请求失败：${error instanceof Error ? error.message : String(error)}`, "UPSTREAM");
+			}
+			const result = parseVideoTask(payload);
+			if (result.status === "completed") {
+				if (result.videos.length === 0) throw new WorkBuddyVideoError("workbuddy video: 任务完成但没有返回任何视频 URL。", "EMPTY_RESULT");
+				return {
+					videos: result.videos,
+					...result.credit !== void 0 ? { credit: result.credit } : {}
+				};
+			}
+			if (result.status === "failed") throw new WorkBuddyVideoError(`workbuddy video: 生视频任务失败（task ${taskId}）。`, "TASK_FAILED");
+			await new Promise((resolve, reject) => {
+				const timer = setTimeout(resolve, VIDEO_POLL_INTERVAL_MS);
+				const onAbort = () => {
+					clearTimeout(timer);
+					reject(new WorkBuddyVideoError("workbuddy video: 轮询被取消。", "POLL_TIMEOUT"));
+				};
+				combined.addEventListener("abort", onAbort, { once: true });
+			});
+		}
+	}
+	/**
+	* 下载一个视频 URL 到本地临时目录，返回绝对路径。
+	*
+	* 官方 CLI 的 `VideoService.downloadVideos` 把每条 `data[].url` 写成本地 `.mp4`
+	* （产物是 COS 签名 URL，和生图同源，但不是图片 MIME）。这里每次一条，工具层
+	* 负责把多条结果各自落盘并回 `file://` 给模型与用户。
+	*/
+	async downloadVideo(credential, url, signal) {
+		const response = await fetch(url, { signal: signal ?? AbortSignal.timeout(VIDEO_DOWNLOAD_TIMEOUT_MS) });
+		if (!response.ok) throw new WorkBuddyVideoError(`workbuddy video: 下载视频失败（HTTP ${response.status}）: ${url}`, "UPSTREAM");
+		const buffer = Buffer.from(await response.arrayBuffer());
+		const dir = join(tmpdir(), "workbuddy-video-gen");
+		await mkdir(dir, { recursive: true });
+		const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
+		const safeUrl = url.replace(/[^A-Za-z0-9._-]+/g, "_").slice(-32);
+		const path = join(dir, `video-${stamp}-${safeUrl}.mp4`);
+		await writeFile(path, buffer);
+		return path;
+	}
 	/** Query today's check-in status without changing account state. */
 	async fetchCheckinStatus(credential) {
 		const response = await fetch(`${billingBase(credential)}/v2/billing/meter/checkin-activity-status`, {
@@ -7137,7 +7566,7 @@ function describeRosterSeenPayload(raw) {
 //#endregion
 //#region src/version.ts
 /** The npm package version this build was produced from. */
-const WORKBUDDY_CONNECT_VERSION = "5.10.0";
+const WORKBUDDY_CONNECT_VERSION = "5.11.0";
 //#endregion
 //#region src/host-heartbeat.ts
 /**
@@ -7295,4 +7724,4 @@ async function clearHostHeartbeat() {
 	await rm(workbuddyHostHeartbeatPath(), { force: true });
 }
 //#endregion
-export { parseCreditMultiplier as $, isEncryptedCredentialError as A, nativeModalityOf as At, WorkBuddyCredentialRejectedError as B, macosBundleExecutable as Bt, WorkBuddyCredentialStore as C, parseImageDataUrl as Ct, defaultDesktopAuthDirs as D, queueNoticeText as Dt, defaultDesktopAuthCandidates as E, parseQueueAnswer as Et, workbuddyAccountId as F, fetchAtRestKeyPayload as Ft, forceNeutralHead as G, hostPeersInfo as Gt, channelGateMemberOf as H, openEncryptedField as Ht, workbuddyOwnAuthPath as I, findWorkbuddyAppExecutable as It, isCredentialRejectedError as J, writeFileAtomic as Jt, isContextTooLongBody as K, resolveDshHome as Kt, CONTEXT_OVERFLOW_MARKER as L, findWorkbuddyAppExecutableWithSource as Lt, legacyWorkbuddyOwnAuthPath as M, clearAtRestKeyCache as Mt, parseWorkBuddyAuth as N, deriveAtRestKey as Nt, defaultDesktopAuthPath as O, NATIVE_MODALITY_BY_MODEL_ID as Ot, preferredAccountName as P, deriveAtRestKeyId as Pt, openingEvidenceOfBody as Q, CREDENTIAL_REJECTED_CODE as R, isEncryptedFieldWrapper as Rt, WORKBUDDY_AUTH_FILE_ENV as S, isBareBase64Image as St, authFileName as T, sniffImageMime as Tt, classifyUpstreamError as U, readAtRestKey as Ut, WorkBuddyUpstreamClient as V, macosNestedAppBundles as Vt, declaredTools as W, workbuddyAppExecutableCandidates as Wt, knownRegionOf as X, isFirstMessageGateBody as Y, modelIdOfBody as Z, deriveCatalog as _, IMAGE_TAG_TEXT_TO_IMAGE as _t, readHostHeartbeat as a, requestEvidenceOf as at, ENCRYPTED_CREDENTIAL_CODE as b, imageDataUrl as bt, WORKBUDDY_CONNECT_VERSION as c, REFUSES_OFF_MODEL_IDS as ct, rosterSeenPath as d, offDefaultFor as dt, parseReasoning as et, piAiRuntimeInfo as f, offRefused as ft, applyContextBudgets as g, IMAGE_TAG_IMAGE_TO_IMAGE as gt, WorkBuddyCatalog as h, DEFAULT_IMAGE_SIZE as ht, processStartTimeMs as i, regionOf as it, isVaultAccountId as j, WORKBUDDY_APP_EXECUTABLE_ENV as jt, hasEncryptedCredentialFields as k, imageDefaultFor as kt, createFileRosterSeenStore as l, defaultOffModelIds as lt, FALLBACK_WORKBUDDY_MODELS_GLOBAL as m, withEffectiveOff as mt, clearHostHeartbeat as n, perturbChannelFingerprints as nt, workbuddyHostHeartbeatPath as o, rewriteSessionTitleModel as ot, FALLBACK_WORKBUDDY_MODELS as p, recordRefusal as pt, isConversationIdGateBody as q, withFileLock as qt, isHeartbeatProcessAlive as r, prepareChatBody as rt, writeHostHeartbeat as s, attachBusyLevels as st, WORKBUDDY_HOST_HEARTBEAT_FILENAME as t, parseUpstreamModel as tt, describeRosterSeenPayload as u, lastRefusalFor as ut, fallbackModelsFor as v, MAX_INPUT_IMAGE_BYTES as vt, WorkBuddyEncryptedCredentialError as w, pickMediaModel as wt, WORKBUDDY_AUTH_FILENAME as x, imageMimeForPath as xt, withoutRouters as y, WorkBuddyImageError as yt, WORKBUDDY_FALLBACK_SYSTEM_PROMPT as z, isWorkbuddyBundle as zt };
+export { parseCreditMultiplier as $, withFileLock as $t, isEncryptedCredentialError as A, pickMediaModel as At, WorkBuddyCredentialRejectedError as B, deriveAtRestKeyId as Bt, WorkBuddyCredentialStore as C, IMAGE_TAG_TEXT_TO_IMAGE as Ct, defaultDesktopAuthDirs as D, imageMimeForPath as Dt, defaultDesktopAuthCandidates as E, imageDataUrl as Et, workbuddyAccountId as F, imageDefaultFor as Ft, forceNeutralHead as G, isWorkbuddyBundle as Gt, channelGateMemberOf as H, findWorkbuddyAppExecutable as Ht, workbuddyOwnAuthPath as I, nativeModalityOf as It, isCredentialRejectedError as J, openEncryptedField as Jt, isContextTooLongBody as K, macosBundleExecutable as Kt, CONTEXT_OVERFLOW_MARKER as L, WORKBUDDY_APP_EXECUTABLE_ENV as Lt, legacyWorkbuddyOwnAuthPath as M, parseQueueAnswer as Mt, parseWorkBuddyAuth as N, queueNoticeText as Nt, defaultDesktopAuthPath as O, isBareBase64Image as Ot, preferredAccountName as P, NATIVE_MODALITY_BY_MODEL_ID as Pt, openingEvidenceOfBody as Q, resolveDshHome as Qt, CREDENTIAL_REJECTED_CODE as R, clearAtRestKeyCache as Rt, WORKBUDDY_AUTH_FILE_ENV as S, IMAGE_TAG_IMAGE_TO_IMAGE as St, authFileName as T, WorkBuddyImageError as Tt, classifyUpstreamError as U, findWorkbuddyAppExecutableWithSource as Ut, WorkBuddyUpstreamClient as V, fetchAtRestKeyPayload as Vt, declaredTools as W, isEncryptedFieldWrapper as Wt, knownRegionOf as X, workbuddyAppExecutableCandidates as Xt, isFirstMessageGateBody as Y, readAtRestKey as Yt, modelIdOfBody as Z, hostPeersInfo as Zt, deriveCatalog as _, WorkBuddyVideoError as _t, readHostHeartbeat as a, requestEvidenceOf as at, ENCRYPTED_CREDENTIAL_CODE as b, resolveVideoParams as bt, WORKBUDDY_CONNECT_VERSION as c, REFUSES_OFF_MODEL_IDS as ct, rosterSeenPath as d, offDefaultFor as dt, writeFileAtomic as en, parseReasoning as et, piAiRuntimeInfo as f, offRefused as ft, applyContextBudgets as g, VIDEO_TAG_TEXT_TO_VIDEO as gt, WorkBuddyCatalog as h, VIDEO_TAG_IMAGE_TO_VIDEO as ht, processStartTimeMs as i, regionOf as it, isVaultAccountId as j, sniffImageMime as jt, hasEncryptedCredentialFields as k, parseImageDataUrl as kt, createFileRosterSeenStore as l, defaultOffModelIds as lt, FALLBACK_WORKBUDDY_MODELS_GLOBAL as m, withEffectiveOff as mt, clearHostHeartbeat as n, perturbChannelFingerprints as nt, workbuddyHostHeartbeatPath as o, rewriteSessionTitleModel as ot, FALLBACK_WORKBUDDY_MODELS as p, recordRefusal as pt, isConversationIdGateBody as q, macosNestedAppBundles as qt, isHeartbeatProcessAlive as r, prepareChatBody as rt, writeHostHeartbeat as s, attachBusyLevels as st, WORKBUDDY_HOST_HEARTBEAT_FILENAME as t, parseUpstreamModel as tt, describeRosterSeenPayload as u, lastRefusalFor as ut, fallbackModelsFor as v, parseSupportedSecondsRange as vt, WorkBuddyEncryptedCredentialError as w, MAX_INPUT_IMAGE_BYTES as wt, WORKBUDDY_AUTH_FILENAME as x, DEFAULT_IMAGE_SIZE as xt, withoutRouters as y, pickVideoModel as yt, WORKBUDDY_FALLBACK_SYSTEM_PROMPT as z, deriveAtRestKey as zt };