@coze-arch/cli 0.0.18 → 0.0.19-alpha.502ddf

package/lib/__templates__/pi-agent/tests/web-search.test.ts

@@ -0,0 +1,208 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { SearchClient, type SearchResponse } from "coze-coding-dev-sdk";
+import { cozeWebSearchTool } from "../src/tools/web-search/index.js";
+
+function resultText(result: { content: { type: string; text?: string }[] }): string {
+  return result.content[0].text ?? "";
+}
+
+function makeWebSearchResponse(overrides: Partial<SearchResponse> = {}): SearchResponse {
+  return {
+    web_items: [
+      {
+        id: "1",
+        sort_id: 1,
+        title: "Result A",
+        site_name: "example.com",
+        url: "https://example.com/a",
+        snippet: "Snippet A",
+        auth_info_des: "",
+        auth_info_level: 0,
+      },
+      {
+        id: "2",
+        sort_id: 2,
+        title: "Result B",
+        url: "https://example.com/b",
+        snippet: "Snippet B",
+        publish_time: "2025-01-01",
+        auth_info_des: "",
+        auth_info_level: 0,
+      },
+    ],
+    image_items: [],
+    ...overrides,
+  };
+}
+
+function makeImageSearchResponse(): SearchResponse {
+  return {
+    web_items: [],
+    image_items: [
+      {
+        id: "img-1",
+        sort_id: 1,
+        title: "Cat Photo",
+        url: "https://example.com/cat",
+        site_name: "photos.com",
+        image: { url: "https://cdn.com/cat.jpg", width: 800, height: 600, shape: "rect" },
+      },
+      {
+        id: "img-2",
+        sort_id: 2,
+        url: "https://example.com/dog",
+        image: { url: "https://cdn.com/dog.jpg", width: 1024, height: 768, shape: "rect" },
+      },
+    ],
+  };
+}
+
+test("web-search: basic web search returns formatted text", async (t) => {
+  const resp = makeWebSearchResponse();
+  t.mock.method(SearchClient.prototype, "webSearch", async () => resp);
+
+  const result = await cozeWebSearchTool.execute("call-1", { query: "test" }, undefined as any, undefined as any, undefined as any);
+  const text = resultText(result);
+
+  assert.ok(text.includes("Coze web search: test"));
+  assert.ok(text.includes("Results (2)"));
+  assert.ok(text.includes("1. Result A"));
+  assert.ok(text.includes("URL: https://example.com/a"));
+  assert.ok(text.includes("Source: example.com"));
+  assert.ok(text.includes("Snippet A"));
+  assert.ok(text.includes("2. Result B"));
+  assert.ok(text.includes("Published: 2025-01-01"));
+});
+
+test("web-search: includes summary when present", async (t) => {
+  const resp = makeWebSearchResponse({ summary: "This is the summary" });
+  t.mock.method(SearchClient.prototype, "webSearch", async () => resp);
+
+  const result = await cozeWebSearchTool.execute("call-2", { query: "test", needSummary: true }, undefined as any, undefined as any, undefined as any);
+  const text = resultText(result);
+
+  assert.ok(text.includes("Summary: This is the summary"));
+});
+
+test("web-search: includes content when needContent is true", async (t) => {
+  const resp = makeWebSearchResponse();
+  resp.web_items[0].content = "Full page content here";
+  t.mock.method(SearchClient.prototype, "advancedSearch", async () => resp);
+
+  const result = await cozeWebSearchTool.execute("call-3", { query: "test", needContent: true }, undefined as any, undefined as any, undefined as any);
+  const text = resultText(result);
+
+  assert.ok(text.includes("Content:"));
+  assert.ok(text.includes("Full page content here"));
+});
+
+test("web-search: image search maps image items", async (t) => {
+  const resp = makeImageSearchResponse();
+  t.mock.method(SearchClient.prototype, "imageSearch", async () => resp);
+
+  const result = await cozeWebSearchTool.execute("call-4", { query: "cats", type: "image" }, undefined as any, undefined as any, undefined as any);
+  const text = resultText(result);
+
+  assert.ok(text.includes("1. Cat Photo"));
+  assert.ok(text.includes("Image: https://cdn.com/cat.jpg"));
+  assert.ok(text.includes("2. Untitled"));
+  assert.ok(text.includes("Image: https://cdn.com/dog.jpg"));
+  assert.equal((result as any).details.type, "image");
+});
+
+test("web-search: uses advancedSearch when filters are present", async (t) => {
+  const resp = makeWebSearchResponse();
+  const calls: string[] = [];
+  t.mock.method(SearchClient.prototype, "advancedSearch", async () => {
+    calls.push("advancedSearch");
+    return resp;
+  });
+  t.mock.method(SearchClient.prototype, "webSearch", async () => {
+    calls.push("webSearch");
+    return resp;
+  });
+
+  await cozeWebSearchTool.execute("call-5", { query: "test", timeRange: "1d" }, undefined as any, undefined as any, undefined as any);
+  assert.deepEqual(calls, ["advancedSearch"]);
+});
+
+test("web-search: uses webSearch when no filters present", async (t) => {
+  const resp = makeWebSearchResponse();
+  const calls: string[] = [];
+  t.mock.method(SearchClient.prototype, "advancedSearch", async () => {
+    calls.push("advancedSearch");
+    return resp;
+  });
+  t.mock.method(SearchClient.prototype, "webSearch", async () => {
+    calls.push("webSearch");
+    return resp;
+  });
+
+  await cozeWebSearchTool.execute("call-6", { query: "test" }, undefined as any, undefined as any, undefined as any);
+  assert.deepEqual(calls, ["webSearch"]);
+});
+
+test("web-search: uses advancedSearch when sites filter is set", async (t) => {
+  const resp = makeWebSearchResponse();
+  const calls: string[] = [];
+  t.mock.method(SearchClient.prototype, "advancedSearch", async () => {
+    calls.push("advancedSearch");
+    return resp;
+  });
+  t.mock.method(SearchClient.prototype, "webSearch", async () => {
+    calls.push("webSearch");
+    return resp;
+  });
+
+  await cozeWebSearchTool.execute("call-7", { query: "test", sites: "example.com" }, undefined as any, undefined as any, undefined as any);
+  assert.deepEqual(calls, ["advancedSearch"]);
+});
+
+test("web-search: returns error content on search failure", async (t) => {
+  t.mock.method(SearchClient.prototype, "webSearch", async () => {
+    throw new Error("API timeout");
+  });
+
+  const result = await cozeWebSearchTool.execute("call-8", { query: "test" }, undefined as any, undefined as any, undefined as any);
+
+  assert.ok(resultText(result).includes("Error: API timeout"));
+  assert.equal((result as any).details.error, true);
+});
+
+test("web-search: defaults count to 10 and type to web", async (t) => {
+  const captured: any[] = [];
+  t.mock.method(SearchClient.prototype, "webSearch", async (query: string, count: number, needSummary?: boolean) => {
+    captured.push({ query, count, needSummary });
+    return makeWebSearchResponse();
+  });
+
+  await cozeWebSearchTool.execute("call-9", { query: "hello" }, undefined as any, undefined as any, undefined as any);
+
+  assert.equal(captured[0].query, "hello");
+  assert.equal(captured[0].count, 10);
+  assert.equal((captured[0] as any).needSummary, undefined);
+});
+
+test("web-search: details contain correct metadata", async (t) => {
+  const resp = makeWebSearchResponse({ summary: "Sum" });
+  t.mock.method(SearchClient.prototype, "webSearch", async () => resp);
+
+  const result = await cozeWebSearchTool.execute("call-10", { query: "meta test" }, undefined as any, undefined as any, undefined as any);
+
+  assert.equal((result as any).details.query, "meta test");
+  assert.equal((result as any).details.type, "web");
+  assert.equal((result as any).details.summary, "Sum");
+  assert.equal((result as any).details.count, 2);
+});
+
+test("web-search: empty results produces correct output", async (t) => {
+  const resp: SearchResponse = { web_items: [], image_items: [] };
+  t.mock.method(SearchClient.prototype, "webSearch", async () => resp);
+
+  const result = await cozeWebSearchTool.execute("call-11", { query: "nothing" }, undefined as any, undefined as any, undefined as any);
+  const text = resultText(result);
+
+  assert.ok(text.includes("Results (0)"));
+  assert.equal((result as any).details.count, 0);
+});

package/lib/__templates__/pi-agent/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "verbatimModuleSyntax": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "baseUrl": "."
+  },
+  "include": [
+    "src/**/*.ts",
+    "pi-resources/extensions/**/*.ts",
+    "tests/**/*.ts",
+    "types/**/*.d.ts"
+  ]
+}

package/lib/__templates__/pi-agent/types/larksuiteoapi-node-sdk.d.ts

@@ -0,0 +1,113 @@
+declare module "@larksuiteoapi/node-sdk" {
+  export enum AppType {
+    SelfBuild = "SelfBuild"
+  }
+
+  export enum Domain {
+    Feishu = "https://open.feishu.cn",
+    Lark = "https://open.larksuite.com"
+  }
+
+  export enum LoggerLevel {
+    warn = "warn"
+  }
+
+  export interface ClientOptions {
+    appId: string;
+    appSecret: string;
+    appType: AppType;
+    domain?: Domain | string;
+  }
+
+  export interface MessageReplyArgs {
+    path: {
+      message_id: string;
+    };
+    data: {
+      msg_type: string;
+      content: string;
+    };
+  }
+
+  export interface MessageReactionCreateArgs {
+    path: {
+      message_id: string;
+    };
+    data: {
+      reaction_type: {
+        emoji_type: string;
+      };
+    };
+  }
+
+  export interface MessageReactionDeleteArgs {
+    path: {
+      message_id: string;
+      reaction_id: string;
+    };
+  }
+
+  export class Client {
+    constructor(options: ClientOptions);
+    request(args: {
+      method: string;
+      url: string;
+      data: Record<string, never>;
+    }): Promise<{
+      bot?: {
+        open_id?: string;
+      };
+      data?: {
+        bot?: {
+          open_id?: string;
+        };
+      };
+    }>;
+    im: {
+      message: {
+        reply(args: MessageReplyArgs): Promise<unknown>;
+      };
+      messageReaction: {
+        create(args: MessageReactionCreateArgs): Promise<{
+          code?: number;
+          msg?: string;
+          data?: {
+            reaction_id?: string;
+            reaction_type?: {
+              emoji_type?: string;
+            };
+          };
+        }>;
+        delete(args: MessageReactionDeleteArgs): Promise<{
+          code?: number;
+          msg?: string;
+          data?: {
+            reaction_id?: string;
+            reaction_type?: {
+              emoji_type?: string;
+            };
+          };
+        }>;
+      };
+    };
+  }
+
+  export class EventDispatcher {
+    constructor(options: {
+      encryptKey: string;
+      verificationToken: string;
+    });
+    register(handlers: Record<string, (data: unknown) => Promise<void> | void>): void;
+  }
+
+  export class WSClient {
+    constructor(options: {
+      appId: string;
+      appSecret: string;
+      domain?: Domain | string;
+      loggerLevel?: LoggerLevel;
+    });
+    start(args: { eventDispatcher: EventDispatcher }): Promise<void>;
+    close(args?: { force?: boolean }): void;
+  }
+}

package/lib/__templates__/taro/.coze

@@ -7,6 +7,7 @@ build = ["bash", ".cozeproj/scripts/dev_build.sh"]
 run = ["bash", ".cozeproj/scripts/dev_run.sh"]
 deps = ["git"] # -> apt install git
 pack = ["bash", ".cozeproj/scripts/pack.sh"]
+validate = ["bash", ".cozeproj/scripts/validate.sh"]
 
 [deploy]
 build = ["bash", ".cozeproj/scripts/deploy_build.sh"]

package/lib/__templates__/taro/.cozeproj/scripts/validate.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+cd "${COZE_WORKSPACE_PATH}"
+
+echo "🔍 Running validate..."
+pnpm validate
+echo "✅ Validate passed!"

package/lib/__templates__/taro/package.json

@@ -19,7 +19,7 @@
     "postinstall": "weapp-tw patch",
     "kill:all": "pkill -9 -f 'concurrently' 2>/dev/null || true; pkill -9 -f 'nest start' 2>/dev/null || true; pkill -9 -f 'taro build' 2>/dev/null || true; pkill -9 -f 'node.*dev' 2>/dev/null || true; echo 'All dev processes cleaned'",
     "lint": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\"",
-    "lint:build": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\" --max-warnings=0",
+    "lint:build": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\" --max-warnings=0 --quiet",
     "lint:fix": "eslint \"src/**/*.{js,jsx,ts,tsx,css}\" --fix",
     "new": "taro new",
     "preview:tt": "taro build --type tt --preview",

package/lib/__templates__/templates.json

@@ -94,6 +94,30 @@
         "additionalProperties": false
       }
     },
+    {
+      "name": "pi-agent",
+      "description": "Pi Agent：`coze init ${COZE_WORKSPACE_PATH} --template pi-agent`\n- 适用：基于 pi-agent-core 的 AI Agent 应用\n- 支持飞书、微信等多渠道接入\n- 内置 Dashboard 管理面板\n- 使用 TypeScript + Express + Vite",
+      "location": "./pi-agent",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {
+          "port": {
+            "type": "number",
+            "default": 5000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Dashboard server port"
+          },
+          "workspaceDir": {
+            "type": "string",
+            "default": "/workspace/workspace",
+            "description": "Workspace directory path"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
     {
       "name": "taro",
       "description": "Taro（小程序 + H5）：`coze init ${COZE_WORKSPACE_PATH} --template taro`\n- 适用：微信小程序、H5 跨端应用\n- 前后端分离架构：Taro 4 + NestJS\n- 支持微信小程序和 H5 双端构建\n- 使用 TailwindCSS + weapp-tailwindcss 实现跨端样式",

package/lib/__templates__/vite/.coze

@@ -4,6 +4,7 @@ requires = ["nodejs-24"]
 [dev]
 build = ["bash", "./scripts/prepare.sh"]
 run = ["bash", "./scripts/dev.sh"]
+validate = ["bash", "./scripts/validate.sh"]
 deps = ["git"] # -> apt install git
 
 [deploy]

package/lib/__templates__/vite/package.json

@@ -7,8 +7,10 @@
     "dev": "bash ./scripts/dev.sh",
     "preinstall": "npx only-allow pnpm",
     "lint": "eslint",
+    "lint:build": "eslint . --quiet",
     "start": "bash ./scripts/start.sh",
-    "ts-check": "tsc -p tsconfig.json"
+    "ts-check": "tsc -p tsconfig.json",
+    "validate": "pnpm run --parallel '/^(ts-check|lint:build)$/'"
   },
   "dependencies": {
     "@supabase/supabase-js": "2.95.3",

package/lib/__templates__/vite/scripts/validate.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+
+cd "${COZE_WORKSPACE_PATH}"
+
+echo "🔍 Running validate..."
+pnpm validate
+echo "✅ Validate passed!"

package/lib/cli.js

@@ -2107,7 +2107,7 @@ const EventBuilder = {
 };
 
 var name = "@coze-arch/cli";
-var version = "0.0.18";
+var version = "0.0.19-alpha.502ddf";
 var description = "coze coding devtools cli";
 var license = "MIT";
 var author = "fanwenjie.fe@bytedance.com";
@@ -5985,7 +5985,6 @@ const getCommandConfig = (
 ) => {
   let commandConfig;
 
-  // 根据命令名称映射到配置路径
   switch (commandName) {
     case 'dev':
       commandConfig = _optionalChain$4([config, 'access', _ => _.dev, 'optionalAccess', _2 => _2.run]);
@@ -5996,6 +5995,9 @@ const getCommandConfig = (
     case 'start':
       commandConfig = _optionalChain$4([config, 'access', _5 => _5.deploy, 'optionalAccess', _6 => _6.run]);
       break;
+    case 'validate':
+      commandConfig = _optionalChain$4([config, 'access', _7 => _7.dev, 'optionalAccess', _8 => _8.validate]);
+      break;
     default:
       throw new Error(`Unknown command: ${commandName}`);
   }
@@ -7100,6 +7102,15 @@ const registerCommand$3 = program => {
     .action(async options => {
       await executeRun('start', options);
     });
+
+  // validate 命令
+  program
+    .command('validate')
+    .description('Validate project (lint + type check)')
+    .option('--log-file <path>', 'Log file path')
+    .action(async options => {
+      await executeRun('validate', options);
+    });
 };
 
 // ABOUTME: Nuxt route scanner

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.18",
+  "version": "0.0.19-alpha.502ddf",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",