@coze-arch/cli 0.0.14 → 0.0.15-alpha.a0f5b9

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

@@ -0,0 +1,157 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { FetchClient, type FetchResponse } from "coze-coding-dev-sdk";
+import { cozeWebFetchTool } from "../src/tools/web-fetch/index.js";
+
+function resultText(result: { content: { type: string; text?: string }[] }): string {
+  return result.content[0].text ?? "";
+}
+
+function makeFetchResponse(overrides: Partial<FetchResponse> = {}): FetchResponse {
+  return {
+    url: "https://example.com",
+    title: "Example Page",
+    content: [
+      { type: "text", text: "Hello world" },
+      { type: "link", text: "Link A", url: "https://a.com" },
+      { type: "image", image: { display_url: "https://img.com/1.png", width: 640, height: 480 } },
+    ],
+    ...overrides,
+  };
+}
+
+test("web-fetch: text format renders numbered items with links and images", async (t) => {
+  const resp = makeFetchResponse();
+  t.mock.method(FetchClient.prototype, "fetch", async () => resp);
+
+  const result = await cozeWebFetchTool.execute("call-1", { urls: "https://example.com" }, undefined as any, undefined as any, undefined as any);
+  const text = resultText(result);
+
+  assert.ok(text.includes("1. Example Page"));
+  assert.ok(text.includes("URL: https://example.com"));
+  assert.ok(text.includes("Hello world"));
+  assert.ok(text.includes("Link A: https://a.com"));
+  assert.ok(text.includes("https://img.com/1.png (640x480)"));
+});
+
+test("web-fetch: markdown format renders headings and markdown links", async (t) => {
+  const resp = makeFetchResponse();
+  t.mock.method(FetchClient.prototype, "fetch", async () => resp);
+
+  const result = await cozeWebFetchTool.execute("call-2", { urls: ["https://example.com"], format: "markdown" }, undefined as any, undefined as any, undefined as any);
+  const text = resultText(result);
+
+  assert.ok(text.includes("# Example Page"));
+  assert.ok(text.includes("- [Link A](https://a.com)"));
+});
+
+test("web-fetch: json format returns valid JSON", async (t) => {
+  const resp = makeFetchResponse();
+  t.mock.method(FetchClient.prototype, "fetch", async () => resp);
+
+  const result = await cozeWebFetchTool.execute("call-3", { urls: "https://example.com", format: "json" }, undefined as any, undefined as any, undefined as any);
+  const parsed = JSON.parse(resultText(result));
+
+  assert.equal(Array.isArray(parsed), true);
+  assert.equal(parsed[0].url, "https://example.com");
+  assert.equal(parsed[0].title, "Example Page");
+  assert.equal(parsed[0].links.length, 1);
+  assert.equal(parsed[0].images.length, 1);
+});
+
+test("web-fetch: textOnly omits links and images", async (t) => {
+  const resp = makeFetchResponse();
+  t.mock.method(FetchClient.prototype, "fetch", async () => resp);
+
+  const result = await cozeWebFetchTool.execute("call-4", { urls: "https://example.com", format: "json", textOnly: true }, undefined as any, undefined as any, undefined as any);
+  const parsed = JSON.parse(resultText(result));
+
+  assert.equal(parsed[0].links.length, 0);
+  assert.equal(parsed[0].images.length, 0);
+});
+
+test("web-fetch: filters out links with missing url", async (t) => {
+  const resp = makeFetchResponse({
+    content: [
+      { type: "text", text: "body" },
+      { type: "link", text: "Valid", url: "https://valid.com" },
+      { type: "link", text: "Missing URL" },
+      { type: "link", text: undefined, url: undefined },
+    ],
+  });
+  t.mock.method(FetchClient.prototype, "fetch", async () => resp);
+
+  const textResult = await cozeWebFetchTool.execute("call-5a", { urls: "https://example.com" }, undefined as any, undefined as any, undefined as any);
+  assert.ok(resultText(textResult).includes("Valid: https://valid.com"));
+  assert.ok(!resultText(textResult).includes("Missing URL"));
+
+  const mdResult = await cozeWebFetchTool.execute("call-5b", { urls: "https://example.com", format: "markdown" }, undefined as any, undefined as any, undefined as any);
+  assert.ok(resultText(mdResult).includes("[Valid](https://valid.com)"));
+  assert.ok(!resultText(mdResult).includes("Missing URL"));
+});
+
+test("web-fetch: image dimensions only shown when both width and height are numbers", async (t) => {
+  const resp = makeFetchResponse({
+    content: [
+      { type: "text", text: "body" },
+      { type: "image", image: { display_url: "https://img.com/a.png", width: 100, height: 200 } },
+      { type: "image", image: { display_url: "https://img.com/b.png", width: 100 } },
+      { type: "image", image: { display_url: "https://img.com/c.png" } },
+    ],
+  });
+  t.mock.method(FetchClient.prototype, "fetch", async () => resp);
+
+  const result = await cozeWebFetchTool.execute("call-6", { urls: "https://example.com" }, undefined as any, undefined as any, undefined as any);
+  const text = resultText(result);
+
+  assert.ok(text.includes("https://img.com/a.png (100x200)"));
+  assert.ok(text.includes("https://img.com/b.png"));
+  assert.ok(!text.includes("b.png (100x"));
+  assert.ok(text.includes("https://img.com/c.png"));
+  assert.ok(!text.includes("c.png ("));
+});
+
+test("web-fetch: concurrent fetching preserves order", async (t) => {
+  const callOrder: number[] = [];
+  let callIndex = 0;
+
+  t.mock.method(FetchClient.prototype, "fetch", async (url: string) => {
+    const idx = callIndex++;
+    const delay = url.includes("slow") ? 50 : 10;
+    await new Promise((r) => setTimeout(r, delay));
+    callOrder.push(idx);
+    return makeFetchResponse({ url, title: `Page ${idx}` });
+  });
+
+  const urls = ["https://slow.com", "https://fast1.com", "https://fast2.com"];
+  const result = await cozeWebFetchTool.execute("call-7", { urls, format: "json" }, undefined as any, undefined as any, undefined as any);
+  const parsed = JSON.parse(resultText(result));
+
+  assert.equal(parsed.length, 3);
+  assert.equal(parsed[0].url, "https://slow.com");
+  assert.equal(parsed[1].url, "https://fast1.com");
+  assert.equal(parsed[2].url, "https://fast2.com");
+});
+
+test("web-fetch: returns error content on fetch failure", async (t) => {
+  t.mock.method(FetchClient.prototype, "fetch", async () => {
+    throw new Error("Connection refused");
+  });
+
+  const result = await cozeWebFetchTool.execute("call-8", { urls: "https://example.com" }, undefined as any, undefined as any, undefined as any);
+
+  assert.ok(resultText(result).includes("Error: Connection refused"));
+  assert.equal((result as any).details.error, true);
+});
+
+test("web-fetch: single url string is normalized to array", async (t) => {
+  const calls: string[] = [];
+  t.mock.method(FetchClient.prototype, "fetch", async (url: string) => {
+    calls.push(url);
+    return makeFetchResponse({ url });
+  });
+
+  await cozeWebFetchTool.execute("call-9", { urls: "https://single.com" }, undefined as any, undefined as any, undefined as any);
+
+  assert.deepEqual(calls, ["https://single.com"]);
+});

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/pnpm-lock.yaml

@@ -197,9 +197,6 @@ importers:
       '@supabase/supabase-js':
         specifier: 2.95.3
         version: 2.95.3
-      better-sqlite3:
-        specifier: ^11.9.1
-        version: 11.10.0
       coze-coding-dev-sdk:
         specifier: ^0.7.16
         version: 0.7.16(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0)
@@ -234,9 +231,6 @@ importers:
       '@nestjs/schematics':
         specifier: ^10.2.3
         version: 10.2.3(chokidar@3.6.0)(typescript@5.9.3)
-      '@types/better-sqlite3':
-        specifier: ^7.6.13
-        version: 7.6.13
       '@types/express':
         specifier: 5.0.6
         version: 5.0.6
@@ -15586,6 +15580,7 @@ snapshots:
   '@types/better-sqlite3@7.6.13':
     dependencies:
       '@types/node': 22.19.6
+    optional: true
 
   '@types/body-parser@1.19.6':
     dependencies:
@@ -16921,6 +16916,7 @@ snapshots:
     dependencies:
       bindings: 1.5.0
       prebuild-install: 7.1.3
+    optional: true
 
   big-integer@1.6.52: {}
 
@@ -16936,6 +16932,7 @@ snapshots:
   bindings@1.5.0:
     dependencies:
       file-uri-to-path: 1.0.0
+    optional: true
 
   bl@1.2.3:
     dependencies:
@@ -17239,7 +17236,8 @@ snapshots:
     dependencies:
       readdirp: 5.0.0
 
-  chownr@1.1.4: {}
+  chownr@1.1.4:
+    optional: true
 
   chroma-js@2.6.0: {}
 
@@ -17735,6 +17733,7 @@ snapshots:
   decompress-response@6.0.0:
     dependencies:
       mimic-response: 3.1.0
+    optional: true
 
   decompress-tar@4.1.1:
     dependencies:
@@ -18491,7 +18490,8 @@ snapshots:
 
   exif-parser@0.1.12: {}
 
-  expand-template@2.0.3: {}
+  expand-template@2.0.3:
+    optional: true
 
   express@4.21.2:
     dependencies:
@@ -18679,7 +18679,8 @@ snapshots:
 
   file-type@8.1.0: {}
 
-  file-uri-to-path@1.0.0: {}
+  file-uri-to-path@1.0.0:
+    optional: true
 
   filename-reserved-regex@2.0.0: {}
 
@@ -18963,7 +18964,8 @@ snapshots:
 
   git-clone@0.1.0: {}
 
-  github-from-package@0.0.0: {}
+  github-from-package@0.0.0:
+    optional: true
 
   glob-parent@5.1.2:
     dependencies:
@@ -20214,7 +20216,8 @@ snapshots:
 
   mimic-response@1.0.1: {}
 
-  mimic-response@3.1.0: {}
+  mimic-response@3.1.0:
+    optional: true
 
   min-document@2.19.2:
     dependencies:
@@ -20446,7 +20449,8 @@ snapshots:
 
   mkdir-p@0.0.7: {}
 
-  mkdirp-classic@0.5.3: {}
+  mkdirp-classic@0.5.3:
+    optional: true
 
   mkdirp@0.5.6:
     dependencies:
@@ -20503,7 +20507,8 @@ snapshots:
 
   nanoid@3.3.11: {}
 
-  napi-build-utils@2.0.0: {}
+  napi-build-utils@2.0.0:
+    optional: true
 
   natural-compare@1.4.0: {}
 
@@ -20545,6 +20550,7 @@ snapshots:
   node-abi@3.87.0:
     dependencies:
       semver: 7.7.4
+    optional: true
 
   node-abort-controller@3.1.1: {}
 
@@ -21505,6 +21511,7 @@ snapshots:
       simple-get: 4.0.1
       tar-fs: 2.1.4
       tunnel-agent: 0.6.0
+    optional: true
 
   prelude-ls@1.2.1: {}
 
@@ -22232,13 +22239,15 @@ snapshots:
 
   signal-exit@4.1.0: {}
 
-  simple-concat@1.0.1: {}
+  simple-concat@1.0.1:
+    optional: true
 
   simple-get@4.0.1:
     dependencies:
       decompress-response: 6.0.0
       once: 1.4.0
       simple-concat: 1.0.1
+    optional: true
 
   simple-plist@1.3.1:
     dependencies:
@@ -22650,6 +22659,7 @@ snapshots:
       mkdirp-classic: 0.5.3
       pump: 3.0.3
       tar-stream: 2.2.0
+    optional: true
 
   tar-stream@1.6.2:
     dependencies:

package/lib/__templates__/taro/server/package.json

@@ -17,7 +17,6 @@
     "@nestjs/core": "^10.4.15",
     "@nestjs/platform-express": "^10.4.15",
     "@supabase/supabase-js": "2.95.3",
-    "better-sqlite3": "^11.9.1",
     "coze-coding-dev-sdk": "^0.7.16",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
@@ -31,7 +30,6 @@
   "devDependencies": {
     "@nestjs/cli": "^10.4.9",
     "@nestjs/schematics": "^10.2.3",
-    "@types/better-sqlite3": "^7.6.13",
     "@types/express": "5.0.6",
     "@types/node": "^22.10.2",
     "drizzle-kit": "^0.31.8",