From 310b3830faa5cef246fb753a3b751135f39e501a Mon Sep 17 00:00:00 2001
From: superche <35420957+superche@users.noreply.github.com>
Date: Wed, 22 Jul 2026 21:33:29 +0800
Subject: [PATCH 1/2] fix(xiaoyunque): support reference video assets

---
 bun.lock                                      |   4 +-
 .../xiaoyunque-generation/convax-package.json |   4 +-
 .../xiaoyunque-generation/package.json        |   2 +-
 .../package/manifest.json                     |   2 +-
 packages/tools/xiaoyunque-mcp/package.json    |   2 +-
 .../scripts/live-image-smoke.ts               |   2 +-
 .../scripts/live-video-smoke.ts               |   2 +-
 .../tools/xiaoyunque-mcp/src/mcp-server.ts    |  11 +-
 .../xiaoyunque-mcp/src/xiaoyunque-api.ts      |  27 +++--
 .../xiaoyunque-mcp/test/generator.test.ts     | 104 ++++++++++++++++++
 .../xiaoyunque-mcp/test/mcp-process.test.ts   |   2 +-
 .../test/mcp-server-errors.test.ts            |   7 ++
 .../test/xiaoyunque-api.test.ts               |  91 +++++++++++++++
 registry/config.json                          |   2 +-
 tooling/registry.test.js                      |   8 +-
 15 files changed, 244 insertions(+), 26 deletions(-)

diff --git a/bun.lock b/bun.lock
index ac2e31b..a678512 100644
--- a/bun.lock
+++ b/bun.lock
@@ -20,7 +20,7 @@
     },
     "packages/plugins/xiaoyunque-generation": {
       "name": "@microvoid/convax-plugin-xiaoyunque-generation",
-      "version": "0.3.4",
+      "version": "0.3.5",
       "dependencies": {
         "@microvoid/convax-xiaoyunque-mcp": "workspace:*"
       }
@@ -83,7 +83,7 @@
     },
     "packages/tools/xiaoyunque-mcp": {
       "name": "@microvoid/convax-xiaoyunque-mcp",
-      "version": "0.3.2",
+      "version": "0.3.3",
       "devDependencies": {
         "@types/bun": "1.3.14",
         "typescript": "5.9.3"
diff --git a/packages/plugins/xiaoyunque-generation/convax-package.json b/packages/plugins/xiaoyunque-generation/convax-package.json
index 17353b8..b29110e 100644
--- a/packages/plugins/xiaoyunque-generation/convax-package.json
+++ b/packages/plugins/xiaoyunque-generation/convax-package.json
@@ -4,7 +4,7 @@
   "id": "xiaoyunque-generation",
   "name": "小云雀生成",
   "description": "通过宿主管理的小云雀网页授权展示服务状态，并使用小云雀第一方网页能力生成图片和视频。",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "license": "MIT",
   "compatibility": {
     "pluginSchema": "convax.plugin/3",
@@ -13,7 +13,7 @@
   "companions": [
     {
       "command": "convax-xiaoyunque-mcp",
-      "version": "0.3.2",
+      "version": "0.3.3",
       "source": "packages/tools/xiaoyunque-mcp",
       "targets": [
         {
diff --git a/packages/plugins/xiaoyunque-generation/package.json b/packages/plugins/xiaoyunque-generation/package.json
index 03e8d11..a07f003 100644
--- a/packages/plugins/xiaoyunque-generation/package.json
+++ b/packages/plugins/xiaoyunque-generation/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@microvoid/convax-plugin-xiaoyunque-generation",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "private": true,
   "type": "module",
   "dependencies": {
diff --git a/packages/plugins/xiaoyunque-generation/package/manifest.json b/packages/plugins/xiaoyunque-generation/package/manifest.json
index 1d9bbc4..5989add 100644
--- a/packages/plugins/xiaoyunque-generation/package/manifest.json
+++ b/packages/plugins/xiaoyunque-generation/package/manifest.json
@@ -3,7 +3,7 @@
   "id": "xiaoyunque-generation",
   "name": "小云雀生成",
   "description": "通过宿主管理的小云雀网页授权展示服务状态，并使用小云雀第一方网页能力生成图片和视频。",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "contributes": {
     "generation": {
       "models": [
diff --git a/packages/tools/xiaoyunque-mcp/package.json b/packages/tools/xiaoyunque-mcp/package.json
index 9905b53..626418c 100644
--- a/packages/tools/xiaoyunque-mcp/package.json
+++ b/packages/tools/xiaoyunque-mcp/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@microvoid/convax-xiaoyunque-mcp",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "private": true,
   "type": "module",
   "bin": {
diff --git a/packages/tools/xiaoyunque-mcp/scripts/live-image-smoke.ts b/packages/tools/xiaoyunque-mcp/scripts/live-image-smoke.ts
index 9e4fc10..c46292e 100644
--- a/packages/tools/xiaoyunque-mcp/scripts/live-image-smoke.ts
+++ b/packages/tools/xiaoyunque-mcp/scripts/live-image-smoke.ts
@@ -55,7 +55,7 @@ function notify(method: string, params: unknown) {
 try {
   const initialized = await request("initialize", {
     capabilities: {},
-    clientInfo: { name: "convax-xiaoyunque-live-smoke", version: "0.3.2" },
+    clientInfo: { name: "convax-xiaoyunque-live-smoke", version: "0.3.3" },
     protocolVersion: "2025-03-26",
   })
   if ((initialized.result as Record<string, unknown> | undefined)?.protocolVersion !== "2025-03-26") {
diff --git a/packages/tools/xiaoyunque-mcp/scripts/live-video-smoke.ts b/packages/tools/xiaoyunque-mcp/scripts/live-video-smoke.ts
index 6723535..eadb676 100644
--- a/packages/tools/xiaoyunque-mcp/scripts/live-video-smoke.ts
+++ b/packages/tools/xiaoyunque-mcp/scripts/live-video-smoke.ts
@@ -117,7 +117,7 @@ try {
   progress("mcp.initialize")
   const initialized = await request("initialize", {
     capabilities: {},
-    clientInfo: { name: "convax-xiaoyunque-live-video-smoke", version: "0.3.2" },
+    clientInfo: { name: "convax-xiaoyunque-live-video-smoke", version: "0.3.3" },
     protocolVersion: "2025-03-26",
   })
   if ((initialized.result as Record<string, unknown> | undefined)?.protocolVersion !== "2025-03-26") {
diff --git a/packages/tools/xiaoyunque-mcp/src/mcp-server.ts b/packages/tools/xiaoyunque-mcp/src/mcp-server.ts
index ae5b890..a7fdb45 100644
--- a/packages/tools/xiaoyunque-mcp/src/mcp-server.ts
+++ b/packages/tools/xiaoyunque-mcp/src/mcp-server.ts
@@ -153,7 +153,9 @@ export function publicGenerationErrorMessage(error: unknown) {
     return "The selected XiaoYunque image model is no longer available. Choose another image model and try again."
   }
   if (error instanceof XiaoYunqueReferenceAssetRegistrationError) {
-    return "XiaoYunque could not prepare the reference image for generation. No generation was submitted; try again."
+    return error.referenceType === "video"
+      ? "XiaoYunque could not prepare the reference video for generation. No generation was submitted; try again."
+      : "XiaoYunque could not prepare the reference image for generation. No generation was submitted; try again."
   }
   if (error instanceof XiaoYunqueRequestRejectedError) {
     return "XiaoYunque did not accept this generation request. Refresh Services and try a model listed for this capability."
@@ -169,6 +171,7 @@ export const safeGenerationDiagnosticCodes = [
   "status-check-timeout",
   "unsupported-image-model",
   "reference-image-registration-failed",
+  "reference-video-registration-failed",
   "upstream-envelope-rejected",
   "upstream-http-rejected",
   "upstream-request-rejected",
@@ -185,7 +188,9 @@ export function safeGenerationDiagnosticCode(error: unknown): SafeGenerationDiag
   if (error instanceof XiaoYunqueQueryTimeoutError) return "status-check-timeout"
   if (error instanceof XiaoYunqueUnsupportedImageModelError) return "unsupported-image-model"
   if (error instanceof XiaoYunqueReferenceAssetRegistrationError) {
-    return "reference-image-registration-failed"
+    return error.referenceType === "video"
+      ? "reference-video-registration-failed"
+      : "reference-image-registration-failed"
   }
   if (error instanceof XiaoYunqueRequestRejectedError) return error.diagnosticCode
   return "unclassified-failure"
@@ -304,7 +309,7 @@ export class McpServer {
       this.#sendResult(request.id, {
         capabilities: { tools: {} },
         protocolVersion,
-        serverInfo: { name: "convax-xiaoyunque-mcp", version: "0.3.2" },
+        serverInfo: { name: "convax-xiaoyunque-mcp", version: "0.3.3" },
       })
       return
     }
diff --git a/packages/tools/xiaoyunque-mcp/src/xiaoyunque-api.ts b/packages/tools/xiaoyunque-mcp/src/xiaoyunque-api.ts
index e227220..84ad894 100644
--- a/packages/tools/xiaoyunque-mcp/src/xiaoyunque-api.ts
+++ b/packages/tools/xiaoyunque-mcp/src/xiaoyunque-api.ts
@@ -37,9 +37,11 @@ export class XiaoYunqueQueryTimeoutError extends Error {
  */
 export class XiaoYunqueReferenceAssetRegistrationError extends Error {
   override name = "XiaoYunqueReferenceAssetRegistrationError"
+  readonly referenceType: "image" | "video"
 
-  constructor() {
-    super("XiaoYunque reference image asset registration failed")
+  constructor(referenceType: "image" | "video" = "image") {
+    super(`XiaoYunque reference ${referenceType} asset registration failed`)
+    this.referenceType = referenceType
   }
 }
 
@@ -618,27 +620,36 @@ export class XiaoYunqueApi {
     const response = await this.#request(uploadPath, session, signal, { body, method: "POST" })
     const payload = requireSuccess(response.value, response.status, "XiaoYunque reference upload")
     const asset = uploadedAsset(payload.data, reference, assetType, this.#allowLoopbackTest)
-    if (assetType !== 2 || asset.pippitAssetId !== undefined) return asset
+    const registeredAssetType = assetType === 2 ? 1 : assetType === 1 ? 2 : undefined
+    if (registeredAssetType === undefined || asset.pippitAssetId !== undefined) return asset
 
     return {
       ...asset,
-      pippitAssetId: await this.#registerUploadedImage(asset.assetId, session, signal),
+      pippitAssetId: await this.#registerUploadedAsset(
+        asset.assetId,
+        registeredAssetType,
+        session,
+        signal,
+      ),
     }
   }
 
-  async #registerUploadedImage(
+  async #registerUploadedAsset(
     assetId: string,
+    assetType: 1 | 2,
     session: StoredWebSession,
     signal: AbortSignal,
   ) {
     try {
       // `upload_file.asset_id` is an EverPhoto source id. The first-party Web
       // product converts it into the identity consumed by image and video generation via
-      // AssetCreateV2; the two ids are deliberately never treated as aliases.
+      // AssetCreateV2; the two ids are deliberately never treated as aliases. The
+      // upload_file and AssetCreateV2 asset-type enums differ: upload 2/1 maps to
+      // registered image/video 1/2 respectively.
       const response = await this.#jsonRequest(assetCreateV2Path, {
         asset_source_type: 3,
         asset_source_id: assetId,
-        asset_type: 1,
+        asset_type: assetType,
         Base: { Client: "web" },
       }, session, signal)
       const payload = requireAssetRegistrationSuccess(response.value, response.status)
@@ -651,7 +662,7 @@ export class XiaoYunqueApi {
     } catch (error) {
       if (signal.aborted) throw cancellationError(signal)
       if (error instanceof XiaoYunqueAuthenticationError) throw error
-      throw new XiaoYunqueReferenceAssetRegistrationError()
+      throw new XiaoYunqueReferenceAssetRegistrationError(assetType === 1 ? "image" : "video")
     }
   }
 
diff --git a/packages/tools/xiaoyunque-mcp/test/generator.test.ts b/packages/tools/xiaoyunque-mcp/test/generator.test.ts
index 425d8a8..4abe54b 100644
--- a/packages/tools/xiaoyunque-mcp/test/generator.test.ts
+++ b/packages/tools/xiaoyunque-mcp/test/generator.test.ts
@@ -482,6 +482,110 @@ describe("XiaoYunque generation engine", () => {
     }
   })
 
+  test("registers and submits one Canvas reference video for video generation", async () => {
+    const directory = await mkdtemp(path.join(os.tmpdir(), "xiaoyunque-reference-video-"))
+    directories.push(directory)
+    const output = path.join(directory, "output")
+    const referenceVideo = path.join(directory, "reference.mp4")
+    await Promise.all([mkdir(output), writeFile(referenceVideo, mp4)])
+    let uploadCount = 0
+    let registrationCount = 0
+    let submittedBody: Record<string, unknown> | undefined
+    let submittedTask: ReturnType<typeof taskFromSubmitBody> | undefined
+    const server = Bun.serve({
+      hostname: "127.0.0.1",
+      port: 0,
+      fetch: async (request): Promise<Response> => {
+        const url = new URL(request.url)
+        if (url.pathname === "/api/web/v1/common/upload_file") {
+          uploadCount += 1
+          const form = await request.formData()
+          expect(path.basename((form.get("file") as File | null)?.name ?? "")).toBe("reference.mp4")
+          expect(form.get("asset_type")).toBe("1")
+          return Response.json({
+            ret: 0,
+            data: {
+              asset_id: "everphoto-reference-video",
+              download_url: `${url.origin}/uploaded-reference.mp4`,
+              duration_ms: 5_000,
+            },
+          })
+        }
+        if (url.pathname === "/api/biz/v1/asset/create_v2") {
+          registrationCount += 1
+          expect(await request.json()).toEqual({
+            asset_source_type: 3,
+            asset_source_id: "everphoto-reference-video",
+            asset_type: 2,
+            Base: { Client: "web" },
+          })
+          return Response.json({ ret: 0, data: { PippitAssetID: "pippit-reference-video" } })
+        }
+        const accountPreflight = await accountPreflightResponse(request)
+        if (accountPreflight) return accountPreflight
+        if (url.pathname === "/api/biz/v1/agent/submit_run") {
+          submittedBody = await request.json() as Record<string, unknown>
+          submittedTask = taskFromSubmitBody(submittedBody)
+          return Response.json({ ret: 0, data: { accepted: true } })
+        }
+        if (url.pathname === "/api/biz/v1/agent/get_thread") {
+          return Response.json({
+            ret: 0,
+            data: {
+              thread: {
+                thread_id: submittedTask?.threadId,
+                run_list: [{
+                  entry_list: [artifactEntry("biz/x_data_video", `${url.origin}/result.mp4`)],
+                  run_id: submittedTask?.runId,
+                  state: 3,
+                  thread_id: submittedTask?.threadId,
+                }],
+              },
+            },
+          })
+        }
+        if (url.pathname === "/result.mp4") return new Response(mp4, { headers: { "Content-Type": "video/mp4" } })
+        return new Response("not found", { status: 404 })
+      },
+    })
+    const store = new OperationStore(path.join(directory, "state", "operations.json"))
+    const engine = new GenerationEngine({
+      api: new XiaoYunqueApi(`http://127.0.0.1:${server.port}`),
+      authorizer: { session: async () => testSession },
+      operationStore: store,
+      pollIntervalMs: 1,
+    })
+    try {
+      const artifacts = await engine.generate(call({
+        operation_id: "reference-video-generation",
+        output: "video",
+        output_directory: output,
+        references: [{
+          kind: "file",
+          mime_type: "video/mp4",
+          name: "reference.mp4",
+          node_id: "reference-video-node",
+          path: referenceVideo,
+          role: "reference_video",
+        }],
+      }), videoModel, new AbortController().signal)
+
+      expect(artifacts[0]?.mimeType).toBe("video/mp4")
+      expect(uploadCount).toBe(1)
+      expect(registrationCount).toBe(1)
+      expect(directVideoParameters(submittedBody!)).toMatchObject({
+        model: "Seedance_2.0_mini_lite",
+        videos: [{
+          asset_id: "everphoto-reference-video",
+          pippit_asset_id: "pippit-reference-video",
+        }],
+      })
+      expect(await store.find("reference-video-generation")).toMatchObject({ status: "submitted" })
+    } finally {
+      server.stop(true)
+    }
+  })
+
   test("rejects a last frame without a first frame before any API request", async () => {
     const directory = await mkdtemp(path.join(os.tmpdir(), "xiaoyunque-last-frame-only-"))
     directories.push(directory)
diff --git a/packages/tools/xiaoyunque-mcp/test/mcp-process.test.ts b/packages/tools/xiaoyunque-mcp/test/mcp-process.test.ts
index 4db7d3e..ad9313c 100644
--- a/packages/tools/xiaoyunque-mcp/test/mcp-process.test.ts
+++ b/packages/tools/xiaoyunque-mcp/test/mcp-process.test.ts
@@ -253,7 +253,7 @@ describe("MCP process", () => {
       })
       expect(initialized).toMatchObject({
         result: {
-          serverInfo: { name: "convax-xiaoyunque-mcp", version: "0.3.2" },
+          serverInfo: { name: "convax-xiaoyunque-mcp", version: "0.3.3" },
         },
       })
       const authorization = await harness.request("tools/call", { name: "service.authorize", arguments: {} })
diff --git a/packages/tools/xiaoyunque-mcp/test/mcp-server-errors.test.ts b/packages/tools/xiaoyunque-mcp/test/mcp-server-errors.test.ts
index 76ae714..efb2257 100644
--- a/packages/tools/xiaoyunque-mcp/test/mcp-server-errors.test.ts
+++ b/packages/tools/xiaoyunque-mcp/test/mcp-server-errors.test.ts
@@ -38,6 +38,10 @@ describe("safe public generation errors", () => {
       .toBe(
         "XiaoYunque could not prepare the reference image for generation. No generation was submitted; try again.",
       )
+    expect(publicGenerationErrorMessage(new XiaoYunqueReferenceAssetRegistrationError("video")))
+      .toBe(
+        "XiaoYunque could not prepare the reference video for generation. No generation was submitted; try again.",
+      )
     expect(publicGenerationErrorMessage(new XiaoYunqueRequestRejectedError("private rejection detail")))
       .toBe(
         "XiaoYunque did not accept this generation request. Refresh Services and try a model listed for this capability.",
@@ -51,6 +55,7 @@ describe("safe public generation errors", () => {
       publicGenerationErrorMessage(new XiaoYunqueObservationRejectedError("upstream-envelope-rejected")),
       publicGenerationErrorMessage(new XiaoYunqueQueryTimeoutError()),
       publicGenerationErrorMessage(new XiaoYunqueReferenceAssetRegistrationError()),
+      publicGenerationErrorMessage(new XiaoYunqueReferenceAssetRegistrationError("video")),
       publicGenerationErrorMessage(new XiaoYunqueRequestRejectedError("private rejection detail")),
       publicGenerationErrorMessage(new XiaoYunqueUnsupportedImageModelError()),
     ]
@@ -74,6 +79,7 @@ describe("safe public generation errors", () => {
       safeGenerationDiagnosticCode(new XiaoYunqueObservationRejectedError("upstream-http-rejected")),
       safeGenerationDiagnosticCode(new XiaoYunqueQueryTimeoutError(privateDetail)),
       safeGenerationDiagnosticCode(new XiaoYunqueReferenceAssetRegistrationError()),
+      safeGenerationDiagnosticCode(new XiaoYunqueReferenceAssetRegistrationError("video")),
       safeGenerationDiagnosticCode(new XiaoYunqueUnsupportedImageModelError()),
       safeGenerationDiagnosticCode(new XiaoYunqueRequestRejectedError(
         privateDetail,
@@ -87,6 +93,7 @@ describe("safe public generation errors", () => {
       "status-check-rejected",
       "status-check-timeout",
       "reference-image-registration-failed",
+      "reference-video-registration-failed",
       "unsupported-image-model",
       "upstream-envelope-rejected",
       "unclassified-failure",
diff --git a/packages/tools/xiaoyunque-mcp/test/xiaoyunque-api.test.ts b/packages/tools/xiaoyunque-mcp/test/xiaoyunque-api.test.ts
index b0e78a7..c97e86f 100644
--- a/packages/tools/xiaoyunque-mcp/test/xiaoyunque-api.test.ts
+++ b/packages/tools/xiaoyunque-mcp/test/xiaoyunque-api.test.ts
@@ -270,6 +270,7 @@ describe("XiaoYunque first-party Web generation API", () => {
     for (const api of [rejected, incomplete]) {
       const error = await api.upload(reference, session, signal).catch((reason: unknown) => reason)
       expect(error).toBeInstanceOf(XiaoYunqueReferenceAssetRegistrationError)
+      expect((error as XiaoYunqueReferenceAssetRegistrationError).referenceType).toBe("image")
       expect(String(error)).toBe(
         "XiaoYunqueReferenceAssetRegistrationError: XiaoYunque reference image asset registration failed",
       )
@@ -294,6 +295,7 @@ describe("XiaoYunque first-party Web generation API", () => {
         data: {
           asset_id: `asset-${seenTypes.length}`,
           download_url: `https://cdn.example.test/reference-${seenTypes.length}`,
+          pippit_asset_id: `pippit-${seenTypes.length}`,
         },
       })
     })
@@ -318,6 +320,95 @@ describe("XiaoYunque first-party Web generation API", () => {
     expect(seenTypes).toEqual(["1", "4"])
   })
 
+  test("registers an uploaded EverPhoto video with the video AssetCreateV2 type", async () => {
+    const directory = await mkdtemp(path.join(os.tmpdir(), "xiaoyunque-web-register-video-"))
+    directories.push(directory)
+    const referencePath = path.join(directory, "reference.mp4")
+    await writeFile(referencePath, Uint8Array.from([0, 0, 0, 16, 102, 116, 121, 112]))
+    const requests: string[] = []
+    const api = apiFor((url, init) => {
+      requests.push(url.pathname)
+      expectWebHeaders(init?.headers)
+      if (url.pathname === "/api/web/v1/common/upload_file") {
+        const body = init?.body as FormData
+        expect(body.get("asset_type")).toBe("1")
+        return Response.json({
+          ret: 0,
+          data: {
+            asset_id: "asset-video",
+            download_url: "https://cdn.example.test/reference.mp4",
+            duration_ms: 5_000,
+            pippit_asset_id: " ",
+          },
+        })
+      }
+      expect(url.pathname).toBe("/api/biz/v1/asset/create_v2")
+      expect(init?.method).toBe("POST")
+      expect(JSON.parse(String(init?.body))).toEqual({
+        asset_source_type: 3,
+        asset_source_id: "asset-video",
+        asset_type: 2,
+        Base: { Client: "web" },
+      })
+      return Response.json({
+        ret: "0",
+        data: { PippitAssetID: "pippit-video" },
+      })
+    })
+
+    expect(await api.upload({
+      kind: "file",
+      mime_type: "video/mp4",
+      name: "reference.mp4",
+      node_id: "video-node",
+      path: referencePath,
+      role: "reference_video",
+    }, session, signal)).toEqual({
+      assetId: "asset-video",
+      metadata: { durationMilliseconds: 5_000 },
+      name: "reference.mp4",
+      pippitAssetId: "pippit-video",
+      url: "https://cdn.example.test/reference.mp4",
+    })
+    expect(requests).toEqual([
+      "/api/web/v1/common/upload_file",
+      "/api/biz/v1/asset/create_v2",
+    ])
+  })
+
+  test("classifies failed reference video registration without leaking upstream details", async () => {
+    const directory = await mkdtemp(path.join(os.tmpdir(), "xiaoyunque-web-register-video-failure-"))
+    directories.push(directory)
+    const referencePath = path.join(directory, "reference.mp4")
+    await writeFile(referencePath, Uint8Array.from([0, 0, 0, 16, 102, 116, 121, 112]))
+    const api = apiFor((url) => url.pathname === "/api/web/v1/common/upload_file"
+      ? Response.json({
+          ret: 0,
+          data: {
+            asset_id: "asset-video",
+            download_url: "https://cdn.example.test/reference.mp4",
+          },
+        })
+      : Response.json({ ret: 4001, errmsg: "private upstream video detail" }))
+
+    const error = await api.upload({
+      kind: "file",
+      mime_type: "video/mp4",
+      name: "reference.mp4",
+      node_id: "video-node",
+      path: referencePath,
+      role: "reference_video",
+    }, session, signal).catch((reason: unknown) => reason)
+
+    expect(error).toBeInstanceOf(XiaoYunqueReferenceAssetRegistrationError)
+    expect((error as XiaoYunqueReferenceAssetRegistrationError).referenceType).toBe("video")
+    expect(String(error)).toBe(
+      "XiaoYunqueReferenceAssetRegistrationError: XiaoYunque reference video asset registration failed",
+    )
+    expect(String(error)).not.toContain("private upstream video detail")
+    expect(String(error)).not.toContain("asset-video")
+  })
+
   test("submits one image through the first-party Canvas image flow", async () => {
     let submitBabiParam: Record<string, unknown> | undefined
     let submitBody: Record<string, unknown> | undefined
diff --git a/registry/config.json b/registry/config.json
index a55890d..ea67b52 100644
--- a/registry/config.json
+++ b/registry/config.json
@@ -1,4 +1,4 @@
 {
-  "sequence": 23,
+  "sequence": 24,
   "yanked": []
 }
diff --git a/tooling/registry.test.js b/tooling/registry.test.js
index dc53b32..910c6ac 100644
--- a/tooling/registry.test.js
+++ b/tooling/registry.test.js
@@ -85,7 +85,7 @@ describe("source packages", () => {
     }
     expect(xiaoyunque.metadata.companions).toEqual([{
       command: "convax-xiaoyunque-mcp",
-      version: "0.3.2",
+      version: "0.3.3",
       source: "packages/tools/xiaoyunque-mcp",
       targets: [{
         platform: "darwin",
@@ -170,9 +170,9 @@ describe("source packages", () => {
     expect(readStoredZip(hello.zip).map((entry) => entry.relativePath)).toContain("manifest.json")
     expect(readStoredZip(xiaoyunque.zip).map((entry) => entry.relativePath)).toEqual(["LICENSE", "manifest.json"])
     expect(xiaoyunque.companionAssets.map((asset) => asset.assetName)).toEqual([
-      "convax-companion-convax-xiaoyunque-mcp-0.3.2-darwin-arm64",
+      "convax-companion-convax-xiaoyunque-mcp-0.3.3-darwin-arm64",
     ])
-    expect(xiaoyunque.tag).toBe("plugin-xiaoyunque-generation-v0.3.4")
+    expect(xiaoyunque.tag).toBe("plugin-xiaoyunque-generation-v0.3.5")
     expect(await fs.readFile(xiaoyunque.companionAssets[0].path)).toEqual(xiaoyunque.companionAssets[0].data)
     expect(readStoredZip(skill.zip).map((entry) => entry.relativePath)).toContain("SKILL.md")
     expect(readStoredZip(ffmpeg.zip).map((entry) => entry.relativePath)).toEqual([
@@ -308,7 +308,7 @@ describe("source packages", () => {
     expect(helloEntry.artifact.url).toContain("/plugin-hello-convax-v0.2.0/")
     expect(xiaoyunqueEntry.manifest.schema).toBe("convax.plugin/3")
     expect(xiaoyunqueEntry.companions[0].targets[0].artifact.url).toContain(
-      "/convax-companion-convax-xiaoyunque-mcp-0.3.2-darwin-arm64",
+      "/convax-companion-convax-xiaoyunque-mcp-0.3.3-darwin-arm64",
     )
     expect(firstSkill).not.toHaveProperty("manifest")
     expect(ffmpegSkillEntry.ownerPluginId).toBe("ffmpeg-tools")

From dcdba7b8690ccba1fcb626393cf85e1c91c13873 Mon Sep 17 00:00:00 2001
From: superche <35420957+superche@users.noreply.github.com>
Date: Wed, 22 Jul 2026 21:41:14 +0800
Subject: [PATCH 2/2] refactor(xiaoyunque): clarify asset type mapping

---
 .../xiaoyunque-mcp/src/xiaoyunque-api.ts      | 21 +++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/packages/tools/xiaoyunque-mcp/src/xiaoyunque-api.ts b/packages/tools/xiaoyunque-mcp/src/xiaoyunque-api.ts
index 84ad894..377e130 100644
--- a/packages/tools/xiaoyunque-mcp/src/xiaoyunque-api.ts
+++ b/packages/tools/xiaoyunque-mcp/src/xiaoyunque-api.ts
@@ -138,6 +138,8 @@ interface XiaoYunqueUserInfo {
 }
 
 type FetchLike = typeof fetch
+type UploadAssetType = 1 | 2 | 4
+type RegisteredAssetType = 1 | 2
 
 function record(value: unknown) {
   return value && typeof value === "object" && !Array.isArray(value)
@@ -305,7 +307,7 @@ async function boundedJson(response: Response, label: string) {
   }
 }
 
-function uploadAssetType(reference: FileGenerationReference) {
+function uploadAssetType(reference: FileGenerationReference): UploadAssetType {
   if (reference.role === "reference_video" || reference.mime_type.startsWith("video/")) return 1
   if (reference.role === "audio" || reference.mime_type.startsWith("audio/")) return 4
   if (
@@ -317,10 +319,21 @@ function uploadAssetType(reference: FileGenerationReference) {
   throw new Error("XiaoYunque does not support this reference type")
 }
 
+function registeredAssetTypeForUpload(assetType: UploadAssetType): RegisteredAssetType | undefined {
+  switch (assetType) {
+    case 1: // video
+      return 2
+    case 2: // image
+      return 1
+    case 4: // audio does not require AssetCreateV2 registration
+      return undefined
+  }
+}
+
 function uploadedAsset(
   value: unknown,
   reference: FileGenerationReference,
-  assetType: 1 | 2 | 4,
+  assetType: UploadAssetType,
   allowLoopbackHttp: boolean,
 ): UploadedAsset {
   const data = record(value)
@@ -620,7 +633,7 @@ export class XiaoYunqueApi {
     const response = await this.#request(uploadPath, session, signal, { body, method: "POST" })
     const payload = requireSuccess(response.value, response.status, "XiaoYunque reference upload")
     const asset = uploadedAsset(payload.data, reference, assetType, this.#allowLoopbackTest)
-    const registeredAssetType = assetType === 2 ? 1 : assetType === 1 ? 2 : undefined
+    const registeredAssetType = registeredAssetTypeForUpload(assetType)
     if (registeredAssetType === undefined || asset.pippitAssetId !== undefined) return asset
 
     return {
@@ -636,7 +649,7 @@ export class XiaoYunqueApi {
 
   async #registerUploadedAsset(
     assetId: string,
-    assetType: 1 | 2,
+    assetType: RegisteredAssetType,
     session: StoredWebSession,
     signal: AbortSignal,
   ) {