@cozeclaw/coze-openclaw-plugin 0.1.2 → 0.1.4

package/README.md

@@ -106,20 +106,19 @@ Bundled skills:
 - `coze-asr`: speech to text
 - `coze-image-gen`: image generation
 
-Example commands:
-
-```bash
-node {baseDir}/scripts/tts.mjs --text "Hello from Coze"
-node {baseDir}/scripts/asr.mjs --url "https://example.com/audio.mp3"
-node {baseDir}/scripts/gen.mjs --prompt "A futuristic city at sunset"
-```
-
 ## Notes
 
-- The plugin requires `apiKey` in plugin config and does not fall back to `COZE_*` environment variables
+- The plugin requires `apiKey` in plugin config
 - Skill visibility depends on `plugins.entries.coze-openclaw-plugin.config.apiKey`
-- `coze_web_fetch` fetches URLs sequentially
-- Run `npm test` to execute the maintained unit tests under `./src`
+- The published npm package only includes runtime files, bundled skills, `README.md`, and `LICENSE`
+
+## Contributing
+
+See `./CONTRIBUTING.md` for the supported contribution flow.
+
+## Security
+
+See `./SECURITY.md` for how to report security issues.
 
 ## License
 

package/package.json

@@ -1,11 +1,28 @@
 {
   "name": "@cozeclaw/coze-openclaw-plugin",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "OpenClaw Coze tools and bundled skills",
   "type": "module",
   "scripts": {
-    "test": "vitest run src/config.test.ts src/plugin.test.ts src/skill-cli.test.ts src/tools/web-search.test.ts src/tools/web-fetch.test.ts"
+    "test": "vitest run ./src"
   },
+  "files": [
+    "index.ts",
+    "openclaw.plugin.json",
+    "src/client.ts",
+    "src/config.ts",
+    "src/skill-cli.ts",
+    "src/shared/asr.ts",
+    "src/shared/fetch.ts",
+    "src/shared/image-gen.ts",
+    "src/shared/search.ts",
+    "src/shared/tts.ts",
+    "src/tools/web-fetch.ts",
+    "src/tools/web-search.ts",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
   "devDependencies": {
     "openclaw": "v2026.2.6",
     "vitest": "^3.2.4"

package/skills/coze-asr/SKILL.md

@@ -12,16 +12,28 @@ Transcribe audio from a URL or local file using Coze ASR.
 ## Quick start
 
 ```bash
-node {baseDir}/scripts/asr.mjs --url "https://example.com/audio.mp3"
-node {baseDir}/scripts/asr.mjs --file ./recording.mp3
+node {skillDir}/scripts/asr.mjs --url "https://example.com/audio.mp3"
+node {skillDir}/scripts/asr.mjs --file ./recording.mp3
 ```
 
 ## Options
 
-- `--url <url>` remote audio URL
-- `--file <path>` local audio file
+- `--url <url>`, `-u <url>` remote audio URL
+- `--file <path>`, `-f <path>` local audio file
+
+## Behavior
+
+- One of `--url` or `--file` is required.
+- If both `--url` and `--file` are provided, the local file input takes precedence.
+- Local files are read and uploaded as base64 audio content.
+- Supported audio formats follow the SDK/API capability: WAV, MP3, OGG Opus, M4A.
+- Recommended limits from the SDK docs: duration up to 2 hours, size up to 100MB.
+- The CLI prints recognized `text`, and may also print `duration` and `segments`.
+- The CLI does not print full `utterances` details or raw response payload.
+- This skill does not expose custom headers such as `--header`, `-H`, or mock mode.
 
 ## Notes
 
 - The skill runtime requires `plugins.entries.coze-openclaw-plugin.config.apiKey`.
+- `{skillDir}` means the directory containing this `SKILL.md`.
 - Local files are read and uploaded as base64 audio content.

package/skills/coze-image-gen/SKILL.md

@@ -9,23 +9,34 @@ metadata: { "openclaw": { "emoji": "🎨", "requires": { "bins": ["node"], "conf
 
 Generate one or more images from a prompt using Coze.
 
+This skill runs as a Node CLI wrapper around the backend SDK. Do not use the SDK from client-side code.
+
 ## Quick start
 
 ```bash
-node {baseDir}/scripts/gen.mjs --prompt "A futuristic city at sunset"
-node {baseDir}/scripts/gen.mjs --prompt "A serene mountain landscape" --count 2 --size 4K
-node {baseDir}/scripts/gen.mjs --prompt "A hero's journey through magical lands" --sequential --max-sequential 5
+node {skillDir}/scripts/gen.mjs --prompt "A futuristic city at sunset"
+node {skillDir}/scripts/gen.mjs --prompt "A serene mountain landscape" --count 2 --size 4K
+node {skillDir}/scripts/gen.mjs --prompt "A hero's journey through magical lands" --sequential --max-sequential 5
+node {skillDir}/scripts/gen.mjs --prompt "Transform into anime style" --image "https://example.com/input.jpg"
+node {skillDir}/scripts/gen.mjs --prompt "A modern office workspace" --response-format url
 ```
 
 ## Options
 
 - `--prompt <text>` required prompt text
-- `--count <n>` number of generations, default `1`
-- `--size <size>` image size, default `2K`
+- `--count <n>` number of independent generation requests, default `1`
+- `--size <size>` image size: `2K`, `4K`, or `WIDTHxHEIGHT`, default `2K`
+- `--image <url>` reference image URL; repeat the flag to pass multiple images
+- `--response-format <format>` only supports `url`
+- `--watermark <true|false>` whether to keep watermark
+- `--optimize-prompt-mode <mode>` prompt optimization mode passed through to the SDK
 - `--sequential` enable sequential image generation
-- `--max-sequential <n>` max sequential frames, default `5`
+- `--max-sequential <n>` max sequential frames, default `15`
+- `--header <key:value>` custom HTTP header; repeatable, alias `-H`
 
 ## Notes
 
 - The skill runtime requires `plugins.entries.coze-openclaw-plugin.config.apiKey`.
-- URLs are printed directly and are suitable for immediate use.
+- `{skillDir}` means the directory containing this `SKILL.md`.
+- Successful runs print generated URLs directly.
+- This skill does not expose base64 output.

package/skills/coze-tts/SKILL.md

@@ -12,22 +12,74 @@ Generate speech audio URLs from text using Coze TTS.
 ## Quick start
 
 ```bash
-node {baseDir}/scripts/tts.mjs --text "Hello, welcome to our service"
-node {baseDir}/scripts/tts.mjs --texts "Chapter 1" "Chapter 2" --speaker zh_male_m191_uranus_bigtts
-node {baseDir}/scripts/tts.mjs --text "Fast announcement" --speech-rate 30 --format mp3 --sample-rate 48000
+node {skillDir}/scripts/tts.mjs --text "Hello, welcome to our service"
+node {skillDir}/scripts/tts.mjs --texts "Chapter 1" "Chapter 2" --speaker zh_male_m191_uranus_bigtts
+node {skillDir}/scripts/tts.mjs --text "Fast announcement" --speech-rate 30 --format mp3 --sample-rate 48000
 ```
 
 ## Options
 
-- `--text <text>` single text input
-- `--texts <texts...>` multiple text inputs
-- `--speaker <id>` speaker id
-- `--format <fmt>` `mp3`, `pcm`, or `ogg_opus`
-- `--sample-rate <hz>` sample rate
-- `--speech-rate <n>` speech rate adjustment
-- `--loudness-rate <n>` loudness adjustment
+- `--text <text>` single text input. If both `--text` and `--texts` are provided, `--text` takes precedence.
+- `--texts <texts...>` multiple text inputs. Values are read until the next `--flag`.
+- `--speaker <id>` speaker id, default `zh_female_xiaohe_uranus_bigtts`
+- `--format <fmt>` audio format: `mp3`, `pcm`, or `ogg_opus`. Default is SDK default (`mp3`).
+- `--sample-rate <hz>` sample rate. Supported values: `8000`, `16000`, `22050`, `24000`, `32000`, `44100`, `48000`. Default is SDK default (`24000`).
+- `--speech-rate <n>` speech rate adjustment, range `-50` to `100`, default `0`
+- `--loudness-rate <n>` loudness adjustment, range `-50` to `100`, default `0`
+
+## Behavior
+
+- At least one of `--text` or `--texts` is required.
+- This skill currently supports plain text input only. It does not expose `ssml`, `--header`, `-H`, or `--mock`.
+- The CLI prints one audio URL per generated segment. It does not download audio files locally.
+- The CLI does not print `audioSize`, even though the underlying SDK returns it.
+- Invalid ranges or unsupported values are passed through to the SDK and may fail there.
+
+## Sample Rates
+
+Supported: `8000`, `16000`, `22050`, `24000`, `32000`, `44100`, `48000` Hz
+
+- `8000-16000`: Phone quality
+- `22050-24000`: Standard quality (default)
+- `32000-48000`: High quality
+
+## Tuning
+
+- `speechRate`: range `-50` to `100`, default `0`. Negative values slow speech down, positive values speed it up.
+- `loudnessRate`: range `-50` to `100`, default `0`. Negative values make output quieter, positive values make it louder.
+
+## Voices
+
+### General
+
+- `zh_female_xiaohe_uranus_bigtts` `小荷`: 默认，通用女声
+- `zh_female_vv_uranus_bigtts` `Vivi`: 中英双语女声
+- `zh_male_m191_uranus_bigtts` `云舟`: 男声
+- `zh_male_taocheng_uranus_bigtts` `小天`: 男声
+
+### Audiobook / Reading
+
+- `zh_female_xueayi_saturn_bigtts` `雪阿姨`: 儿童有声读物女声
+
+### Video Dubbing
+
+- `zh_male_dayi_saturn_bigtts` `大一`: 男声
+- `zh_female_mizai_saturn_bigtts` `米仔`: 女声
+- `zh_female_jitangnv_saturn_bigtts` `鸡汤女`: 励志女声
+- `zh_female_meilinvyou_saturn_bigtts` `甜美女友`: 甜美女友
+- `zh_female_santongyongns_saturn_bigtts` `三通女声`: 通用流畅女声
+- `zh_male_ruyayichen_saturn_bigtts` `儒雅一尘`: 儒雅男声
+
+### Roleplay
+
+- `saturn_zh_female_keainvsheng_tob` `可爱女生`: 可爱女生
+- `saturn_zh_female_tiaopigongzhu_tob` `俏皮公主`: 俏皮公主
+- `saturn_zh_male_shuanglangshaonian_tob` `爽朗少年`: 爽朗少年
+- `saturn_zh_male_tiancaitongzhuo_tob` `天才同桌`: 天才同桌
+- `saturn_zh_female_cancan_tob` `灿灿`: 知性灿灿
 
 ## Notes
 
 - The skill runtime requires `plugins.entries.coze-openclaw-plugin.config.apiKey`.
+- `{skillDir}` means the directory containing this `SKILL.md`.
 - The script prints one audio URL per generated segment.

package/src/client.ts

@@ -3,12 +3,14 @@ import type { CozeConfig } from "coze-coding-dev-sdk";
 type CozeSdkModule = typeof import("coze-coding-dev-sdk");
 type ConfigurableClientConstructor<TClient> = new (
   config: InstanceType<CozeSdkModule["Config"]>,
+  customHeaders?: Record<string, string>,
 ) => TClient;
 
 let sdkPromise: Promise<CozeSdkModule> | null = null;
 
 export type CozeClientFactoryParams = {
   config: CozeConfig;
+  customHeaders?: Record<string, string>;
 };
 
 export async function loadCozeSdk(): Promise<CozeSdkModule> {
@@ -24,7 +26,7 @@ async function createClient<TClient>(
 ): Promise<TClient> {
   const sdk = await loadCozeSdk();
   const Client = resolveCtor(sdk);
-  return new Client(new sdk.Config(params.config));
+  return new Client(new sdk.Config(params.config), params.customHeaders);
 }
 
 export async function createSearchClient(

package/src/shared/image-gen.ts

@@ -7,6 +7,11 @@ export type ImageGenerationInput = {
   size?: string;
   sequential?: boolean;
   maxSequential?: number;
+  image?: string[];
+  responseFormat?: "url";
+  watermark?: boolean;
+  optimizePromptMode?: string;
+  headers?: Record<string, string>;
 };
 
 export type ImageGenerationResult = {
@@ -18,7 +23,10 @@ export async function generateImages(
   input: ImageGenerationInput,
   clientConfig: CozeConfig,
 ): Promise<ImageGenerationResult[]> {
-  const client = await createImageGenerationClient({ config: clientConfig });
+  const client = await createImageGenerationClient({
+    config: clientConfig,
+    customHeaders: input.headers,
+  });
   const count = input.count ?? 1;
   const results: ImageGenerationResult[] = [];
 
@@ -27,10 +35,17 @@ export async function generateImages(
       prompt: input.prompt,
       size: input.size ?? "2K",
       sequentialImageGeneration: input.sequential ? "auto" : "disabled",
-      sequentialImageGenerationMaxImages: input.maxSequential ?? 5,
+      sequentialImageGenerationMaxImages: input.maxSequential ?? 15,
+      image: input.image && input.image.length > 0 ? input.image : undefined,
+      responseFormat: input.responseFormat,
+      watermark: input.watermark,
+      optimizePromptMode: input.optimizePromptMode,
     };
     const response = await client.generate(request);
     const helper = client.getResponseHelper(response);
+    if (!helper.success) {
+      throw new Error(helper.errorMessages.join("; ") || "Image generation failed");
+    }
     results.push({
       prompt: input.prompt,
       urls: helper.imageUrls,

package/src/skill-cli.ts

@@ -62,6 +62,21 @@ function readTrailingValues(args: string[], name: string): string[] {
   return values;
 }
 
+function readRepeatedArgs(args: string[], names: string[]): string[] {
+  const values: string[] = [];
+  for (let index = 0; index < args.length; index += 1) {
+    if (!names.includes(args[index] ?? "")) {
+      continue;
+    }
+    const value = args[index + 1];
+    if (!value || value.startsWith("-")) {
+      continue;
+    }
+    values.push(value);
+  }
+  return values;
+}
+
 function readNumberArg(args: string[], name: string): number | undefined {
   const value = readArg(args, name);
   if (!value) {
@@ -85,6 +100,47 @@ function findMissingValueFlag(args: string[], names: string[]): string | undefin
   return undefined;
 }
 
+function parseBooleanArg(value: string | undefined, name: string): boolean | undefined {
+  if (value === undefined) {
+    return undefined;
+  }
+  if (value === "true") {
+    return true;
+  }
+  if (value === "false") {
+    return false;
+  }
+  throw new Error(`${name} must be true or false`);
+}
+
+function findHeaderSeparator(value: string): ":" | "=" | undefined {
+  if (value.includes(":")) {
+    return ":";
+  }
+  if (value.includes("=")) {
+    return "=";
+  }
+  return undefined;
+}
+
+function parseHeaders(values: string[]): Record<string, string> {
+  const headers: Record<string, string> = {};
+  for (const value of values) {
+    const separator = findHeaderSeparator(value);
+    if (!separator) {
+      throw new Error(`Invalid header format: ${value}`);
+    }
+    const index = value.indexOf(separator);
+    const key = value.slice(0, index).trim();
+    const headerValue = value.slice(index + 1).trim();
+    if (!key || !headerValue) {
+      throw new Error(`Invalid header format: ${value}`);
+    }
+    headers[key] = headerValue;
+  }
+  return headers;
+}
+
 export async function runImageCli(
   args: string[],
   env: NodeJS.ProcessEnv = process.env,
@@ -95,6 +151,13 @@ export async function runImageCli(
     "--count",
     "--size",
     "--max-sequential",
+    "--image",
+    "--response-format",
+    "--watermark",
+    "--optimize-prompt-mode",
+    "--output",
+    "--header",
+    "-H",
   ]);
   if (missingValueFlag) {
     io.error(`Error: ${missingValueFlag} requires a value`);
@@ -105,6 +168,15 @@ export async function runImageCli(
     io.error("Error: --prompt is required");
     return 1;
   }
+  const responseFormat = readArg(args, "--response-format");
+  if (responseFormat && responseFormat !== "url") {
+    io.error("Error: --response-format only supports url");
+    return 1;
+  }
+  if (args.includes("--output")) {
+    io.error("Error: --output is not supported; this skill only prints image URLs");
+    return 1;
+  }
   try {
     const config = await requireConfig(env);
     const results = await generateImages(
@@ -114,6 +186,11 @@ export async function runImageCli(
         size: readArg(args, "--size"),
         sequential: args.includes("--sequential"),
         maxSequential: readNumberArg(args, "--max-sequential"),
+        image: readRepeatedArgs(args, ["--image"]),
+        responseFormat: responseFormat as "url" | undefined,
+        watermark: parseBooleanArg(readArg(args, "--watermark"), "--watermark"),
+        optimizePromptMode: readArg(args, "--optimize-prompt-mode"),
+        headers: parseHeaders(readRepeatedArgs(args, ["--header", "-H"])),
       },
       config,
     );

package/index.test.ts

@@ -1,63 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { describe, expect, it, vi } from "vitest";
-import plugin from "./index.js";
-
-describe("coze-openclaw-plugin plugin", () => {
-  it("registers coze web tools", () => {
-    const registerTool = vi.fn();
-
-    plugin.register?.({
-      id: "coze-openclaw-plugin",
-      name: "Coze OpenClaw Plugin",
-      description: "Coze OpenClaw",
-      source: "test",
-      config: {},
-      pluginConfig: {},
-      runtime: {} as never,
-      logger: {
-        debug() {},
-        info() {},
-        warn() {},
-        error() {},
-      },
-      registerTool,
-      registerHook() {},
-      registerHttpRoute() {},
-      registerChannel() {},
-      registerGatewayMethod() {},
-      registerCli() {},
-      registerService() {},
-      registerProvider() {},
-      registerCommand() {},
-      registerContextEngine() {},
-      resolvePath(input: string) {
-        return input;
-      },
-      on() {},
-    });
-
-    expect(registerTool).toHaveBeenCalledTimes(2);
-    const toolNames = registerTool.mock.calls
-      .map((call) => {
-        const tool = call[0];
-        return typeof tool === "function" ? undefined : tool.name;
-      })
-      .filter(Boolean);
-    expect(toolNames).toEqual(["coze_web_search", "coze_web_fetch"]);
-  });
-
-  it("declares bundled skills in the plugin manifest", () => {
-    const manifestPath = path.join(
-      process.cwd(),
-      "extensions/coze-openclaw-plugin/openclaw.plugin.json",
-    );
-    const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8")) as {
-      id: string;
-      skills?: string[];
-    };
-
-    expect(manifest.id).toBe("coze-openclaw-plugin");
-    expect(manifest.skills).toEqual(["./skills"]);
-  });
-});

package/src/config.test.ts

@@ -1,130 +0,0 @@
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { afterEach, describe, expect, it } from "vitest";
-import {
-  loadCozePluginConfigFromOpenClawConfig,
-  resolveCozeClientConfig,
-  resolveOpenClawConfigPath,
-} from "./config.js";
-
-const tempDirs: string[] = [];
-
-afterEach(async () => {
-  await Promise.all(tempDirs.splice(0, tempDirs.length).map((dir) => fs.rm(dir, { recursive: true, force: true })));
-});
-
-describe("resolveCozeClientConfig", () => {
-  it("reads values from plugin config", () => {
-    const result = resolveCozeClientConfig(
-      {
-        apiKey: "plugin-key",
-        baseUrl: "https://plugin.example.com",
-        modelBaseUrl: "https://plugin-model.example.com",
-        timeout: 3000,
-      },
-      {} as NodeJS.ProcessEnv,
-    );
-
-    expect(result).toMatchObject({
-      apiKey: "plugin-key",
-      baseUrl: "https://plugin.example.com",
-      modelBaseUrl: "https://plugin-model.example.com",
-      timeout: 3000,
-    });
-  });
-
-  it("does not fall back to environment variables", () => {
-    const result = resolveCozeClientConfig({}, {
-      COZE_API_KEY: "env-key",
-      COZE_BASE_URL: "https://env.example.com",
-      COZE_MODEL_BASE_URL: "https://env-model.example.com",
-      COZE_RETRY_TIMES: "3",
-      COZE_RETRY_DELAY: "100",
-      COZE_TIMEOUT: "3000",
-    } as NodeJS.ProcessEnv);
-
-    expect(result).toEqual({
-      apiKey: undefined,
-      baseUrl: undefined,
-      modelBaseUrl: undefined,
-      retryTimes: undefined,
-      retryDelay: undefined,
-      timeout: undefined,
-    });
-  });
-
-  it("resolves the OpenClaw config path from OPENCLAW_CONFIG_PATH", () => {
-    expect(
-      resolveOpenClawConfigPath({
-        OPENCLAW_CONFIG_PATH: "~/custom/openclaw.json",
-        HOME: "/tmp/example-home",
-      } as NodeJS.ProcessEnv),
-    ).toBe(path.join("/tmp/example-home", "custom", "openclaw.json"));
-  });
-
-  it("loads plugin config from the OpenClaw config file", async () => {
-    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "coze-openclaw-plugin-config-"));
-    tempDirs.push(tempDir);
-    const configPath = path.join(tempDir, "openclaw.json");
-
-    await fs.writeFile(
-      configPath,
-      `{
-        plugins: {
-          entries: {
-            "coze-openclaw-plugin": {
-              config: {
-                apiKey: "plugin-key",
-                baseUrl: "https://plugin.example.com",
-              },
-            },
-          },
-        },
-      }`,
-      "utf-8",
-    );
-
-    const result = await loadCozePluginConfigFromOpenClawConfig({
-      OPENCLAW_CONFIG_PATH: configPath,
-    } as NodeJS.ProcessEnv);
-
-    expect(result).toEqual({
-      apiKey: "plugin-key",
-      baseUrl: "https://plugin.example.com",
-      modelBaseUrl: undefined,
-      retryTimes: undefined,
-      retryDelay: undefined,
-      timeout: undefined,
-    });
-  });
-
-  it("resolves env templates from the OpenClaw config file", async () => {
-    const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "coze-openclaw-plugin-config-"));
-    tempDirs.push(tempDir);
-    const configPath = path.join(tempDir, "openclaw.json");
-
-    await fs.writeFile(
-      configPath,
-      `{
-        plugins: {
-          entries: {
-            "coze-openclaw-plugin": {
-              config: {
-                apiKey: "\${COZE_WORKLOAD_IDENTITY_API_KEY}",
-              },
-            },
-          },
-        },
-      }`,
-      "utf-8",
-    );
-
-    const result = await loadCozePluginConfigFromOpenClawConfig({
-      OPENCLAW_CONFIG_PATH: configPath,
-      COZE_WORKLOAD_IDENTITY_API_KEY: "workload-key",
-    } as NodeJS.ProcessEnv);
-
-    expect(result?.apiKey).toBe("workload-key");
-  });
-});

package/src/plugin.test.ts

@@ -1,62 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-import plugin from "../index.js";
-
-function createApi(pluginConfig: Record<string, unknown>) {
-  return {
-    id: "coze-openclaw-plugin",
-    name: "Coze OpenClaw Plugin",
-    description: "Coze OpenClaw",
-    source: "test",
-    config: {},
-    pluginConfig,
-    runtime: {} as never,
-    logger: {
-      debug() {},
-      info: vi.fn(),
-      warn() {},
-      error() {},
-    },
-    registerTool: vi.fn(),
-    registerHook() {},
-    registerHttpRoute() {},
-    registerChannel() {},
-    registerGatewayMethod() {},
-    registerCli() {},
-    registerService() {},
-    registerProvider() {},
-    registerCommand() {},
-    registerContextEngine() {},
-    resolvePath(input: string) {
-      return input;
-    },
-    on() {},
-  };
-}
-
-describe("plugin registration", () => {
-  it("skips tool registration when apiKey is missing", () => {
-    const api = createApi({});
-
-    plugin.register?.(api);
-
-    expect(api.registerTool).not.toHaveBeenCalled();
-    expect(api.logger.info).toHaveBeenCalledWith(
-      "Skipping Coze tool registration because plugins.entries.coze-openclaw-plugin.config.apiKey is missing.",
-    );
-  });
-
-  it("registers coze web tools when apiKey exists", () => {
-    const api = createApi({ apiKey: "test-key" });
-
-    plugin.register?.(api);
-
-    expect(api.registerTool).toHaveBeenCalledTimes(2);
-    const toolNames = api.registerTool.mock.calls
-      .map((call) => {
-        const tool = call[0];
-        return typeof tool === "function" ? undefined : tool.name;
-      })
-      .filter(Boolean);
-    expect(toolNames).toEqual(["coze_web_search", "coze_web_fetch"]);
-  });
-});

package/src/skill-cli.test.ts

@@ -1,65 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-
-const hoisted = vi.hoisted(() => ({
-  loadCozePluginConfigFromOpenClawConfig: vi.fn(),
-  resolveCozeClientConfig: vi.fn(),
-  synthesizeSpeech: vi.fn(),
-  transcribeSpeech: vi.fn(),
-}));
-
-vi.mock("./config.js", async () => {
-  const actual = await vi.importActual<typeof import("./config.js")>("./config.js");
-  return {
-    ...actual,
-    loadCozePluginConfigFromOpenClawConfig: (...args: unknown[]) =>
-      hoisted.loadCozePluginConfigFromOpenClawConfig(...args),
-    resolveCozeClientConfig: (...args: unknown[]) => hoisted.resolveCozeClientConfig(...args),
-  };
-});
-
-vi.mock("./shared/tts.js", () => ({
-  synthesizeSpeech: (...args: unknown[]) => hoisted.synthesizeSpeech(...args),
-}));
-
-vi.mock("./shared/asr.js", () => ({
-  transcribeSpeech: (...args: unknown[]) => hoisted.transcribeSpeech(...args),
-}));
-
-const { runAsrCli, runTtsCli } = await import("./skill-cli.js");
-
-function createIo() {
-  return {
-    logs: [] as string[],
-    errors: [] as string[],
-    log(message: string) {
-      this.logs.push(message);
-    },
-    error(message: string) {
-      this.errors.push(message);
-    },
-  };
-}
-
-describe("skill cli", () => {
-  it("rejects missing values for single-value flags", async () => {
-    const io = createIo();
-
-    const code = await runAsrCli(["--file", "--url", "https://example.com/audio.mp3"], {}, io);
-
-    expect(code).toBe(1);
-    expect(io.errors).toContain("Error: --file requires a value");
-    expect(hoisted.transcribeSpeech).not.toHaveBeenCalled();
-  });
-
-  it("rejects missing values in tts options before calling the sdk", async () => {
-    hoisted.loadCozePluginConfigFromOpenClawConfig.mockResolvedValue({});
-    hoisted.resolveCozeClientConfig.mockReturnValue({ apiKey: "test-key" });
-    const io = createIo();
-
-    const code = await runTtsCli(["--text", "Hello", "--speaker", "--format", "mp3"], {}, io);
-
-    expect(code).toBe(1);
-    expect(io.errors).toContain("Error: --speaker requires a value");
-    expect(hoisted.synthesizeSpeech).not.toHaveBeenCalled();
-  });
-});

package/src/tools/web-fetch.test.ts

@@ -1,68 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-
-const hoisted = vi.hoisted(() => ({
-  fetchContent: vi.fn(),
-}));
-
-vi.mock("../shared/fetch.js", () => ({
-  fetchContent: (...args: unknown[]) => hoisted.fetchContent(...args),
-}));
-
-const { createCozeWebFetchTool } = await import("./web-fetch.js");
-
-function getTextContent(result: { content: Array<{ type: string; text?: string }> }): string {
-  const first = result.content[0];
-  return first?.type === "text" ? first.text ?? "" : "";
-}
-
-describe("createCozeWebFetchTool", () => {
-  it("fetches multiple urls and returns normalized details", async () => {
-    hoisted.fetchContent.mockResolvedValueOnce([
-      {
-        url: "https://example.com/one",
-        title: "One",
-        text: "First page",
-        links: [],
-        images: [],
-      },
-      {
-        url: "https://example.com/two",
-        title: "Two",
-        text: "Second page",
-        links: [{ title: "Ref", url: "https://example.com/ref" }],
-        images: [],
-      },
-    ]);
-
-    const tool = createCozeWebFetchTool({
-      pluginConfig: { apiKey: "test-key" },
-      logger: {
-        debug() {},
-        info() {},
-        warn() {},
-        error() {},
-      },
-      env: {},
-    });
-
-    const result = await tool.execute("call-1", {
-      urls: ["https://example.com/one", "https://example.com/two"],
-      textOnly: true,
-    });
-
-    expect(hoisted.fetchContent).toHaveBeenCalledWith(
-      expect.objectContaining({
-        urls: ["https://example.com/one", "https://example.com/two"],
-        textOnly: true,
-      }),
-      expect.objectContaining({ apiKey: "test-key" }),
-    );
-    expect(result.details).toMatchObject({
-      count: 2,
-      urls: ["https://example.com/one", "https://example.com/two"],
-    });
-    const text = getTextContent(result);
-    expect(text).toContain("First page");
-    expect(text).toContain("Second page");
-  });
-});

package/src/tools/web-search.test.ts

@@ -1,140 +0,0 @@
-import { describe, expect, it, vi } from "vitest";
-
-const hoisted = vi.hoisted(() => ({
-  searchWeb: vi.fn(),
-}));
-
-vi.mock("../shared/search.js", () => ({
-  searchWeb: (...args: unknown[]) => hoisted.searchWeb(...args),
-}));
-
-const { createCozeWebSearchTool } = await import("./web-search.js");
-
-function getTextContent(result: { content: Array<{ type: string; text?: string }> }): string {
-  const first = result.content[0];
-  return first?.type === "text" ? first.text ?? "" : "";
-}
-
-describe("createCozeWebSearchTool", () => {
-  it("executes web search and returns structured details", async () => {
-    hoisted.searchWeb.mockResolvedValueOnce({
-      query: "OpenClaw",
-      type: "web",
-      summary: "summary",
-      items: [
-        {
-          title: "OpenClaw",
-          url: "https://openclaw.ai",
-          siteName: "OpenClaw",
-          snippet: "AI agent",
-        },
-      ],
-    });
-
-    const tool = createCozeWebSearchTool({
-      pluginConfig: { apiKey: "test-key" },
-      logger: {
-        debug() {},
-        info() {},
-        warn() {},
-        error() {},
-      },
-      env: {},
-    });
-
-    const result = await tool.execute("call-1", {
-      query: "OpenClaw",
-      type: "web",
-      count: 5,
-      needSummary: true,
-    });
-
-    expect(hoisted.searchWeb).toHaveBeenCalledWith(
-      expect.objectContaining({
-        query: "OpenClaw",
-        type: "web",
-        count: 5,
-        needSummary: true,
-      }),
-      expect.objectContaining({ apiKey: "test-key" }),
-    );
-    expect(result.details).toMatchObject({
-      query: "OpenClaw",
-      type: "web",
-      summary: "summary",
-      count: 1,
-    });
-    expect(getTextContent(result)).toContain("OpenClaw");
-  });
-
-  it("supports image search mode", async () => {
-    hoisted.searchWeb.mockResolvedValueOnce({
-      query: "lobster",
-      type: "image",
-      items: [
-        {
-          title: "Lobster",
-          url: "https://example.com/page",
-          imageUrl: "https://example.com/image.png",
-          siteName: "Example",
-        },
-      ],
-    });
-
-    const tool = createCozeWebSearchTool({
-      pluginConfig: { apiKey: "test-key" },
-      logger: {
-        debug() {},
-        info() {},
-        warn() {},
-        error() {},
-      },
-      env: {},
-    });
-
-    const result = await tool.execute("call-2", {
-      query: "lobster",
-      type: "image",
-    });
-
-    expect(result.details).toMatchObject({
-      type: "image",
-      count: 1,
-    });
-    expect(getTextContent(result)).toContain("https://example.com/image.png");
-  });
-
-  it("renders extracted content when needContent is enabled", async () => {
-    hoisted.searchWeb.mockResolvedValueOnce({
-      query: "OpenClaw",
-      type: "web",
-      items: [
-        {
-          title: "OpenClaw",
-          url: "https://openclaw.ai",
-          snippet: "Short summary",
-          content: "Long-form extracted page content.",
-        },
-      ],
-    });
-
-    const tool = createCozeWebSearchTool({
-      pluginConfig: { apiKey: "test-key" },
-      logger: {
-        debug() {},
-        info() {},
-        warn() {},
-        error() {},
-      },
-      env: {},
-    });
-
-    const result = await tool.execute("call-3", {
-      query: "OpenClaw",
-      type: "web",
-      needContent: true,
-    });
-
-    expect(getTextContent(result)).toContain("Long-form extracted page content.");
-  });
-});