npm - chatccc - Versions diffs - 0.2.230 → 0.2.231 - Mend

chatccc 0.2.230 → 0.2.231

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (116) hide show

package/.agents/skills/create-chatccc-feishu-app/SKILL.md +85 -85
package/.claude/skills/create-chatccc-feishu-app/SKILL.md +85 -85
package/.cursor/skills/create-chatccc-feishu-app/SKILL.md +85 -85
package/README.md +90 -90
package/agent-prompts/claude_specific.md +45 -45
package/agent-prompts/codex_specific.md +2 -2
package/agent-prompts/cursor_specific.md +13 -13
package/bin/cccagent.mjs +17 -17
package/im-skills/feishu-skill/receive-send-file.md +63 -63
package/im-skills/feishu-skill/receive-send-image.md +24 -24
package/im-skills/feishu-skill/skill.md +3 -3
package/im-skills/wechat-file-skill/receive-send-file.md +38 -38
package/im-skills/wechat-file-skill/send-file.mjs +83 -83
package/im-skills/wechat-file-skill/skill.md +10 -10
package/im-skills/wechat-image-skill/skill.md +10 -10
package/im-skills/wechat-video-skill/receive-send-video.md +38 -38
package/im-skills/wechat-video-skill/send-video.mjs +79 -79
package/im-skills/wechat-video-skill/skill.md +10 -10
package/package.json +1 -1
package/scripts/postinstall-sharp-check.mjs +58 -58
package/src/__tests__/agent-activity.test.ts +86 -76
package/src/__tests__/agent-delegate-task-rpc.test.ts +165 -165
package/src/__tests__/agent-reload-config-rpc.test.ts +99 -99
package/src/__tests__/builtin-chat-session.test.ts +65 -1
package/src/__tests__/builtin-cli-json.test.ts +39 -39
package/src/__tests__/builtin-config.test.ts +26 -26
package/src/__tests__/builtin-context.test.ts +202 -163
package/src/__tests__/builtin-permissions.test.ts +211 -211
package/src/__tests__/builtin-session-select.test.ts +116 -116
package/src/__tests__/builtin-sigint.test.ts +56 -56
package/src/__tests__/builtin-web-tools.test.ts +220 -220
package/src/__tests__/card-action-routing.test.ts +18 -18
package/src/__tests__/cardkit.test.ts +60 -60
package/src/__tests__/ccc-adapter.test.ts +170 -136
package/src/__tests__/chatgpt-subscription-rpc.test.ts +89 -89
package/src/__tests__/chatgpt-subscription.test.ts +135 -135
package/src/__tests__/chrome-devtools-guard.test.ts +165 -165
package/src/__tests__/claude-adapter.test.ts +614 -614
package/src/__tests__/claude-raw-stream-log.test.ts +87 -87
package/src/__tests__/codex-adapter.test.ts +58 -58
package/src/__tests__/codex-raw-stream-log.test.ts +170 -170
package/src/__tests__/codex-reset-actions.test.ts +146 -146
package/src/__tests__/cursor-adapter.test.ts +268 -268
package/src/__tests__/feishu-api.test.ts +60 -60
package/src/__tests__/feishu-avatar.test.ts +164 -164
package/src/__tests__/feishu-message-ingress.test.ts +138 -138
package/src/__tests__/feishu-platform.test.ts +22 -22
package/src/__tests__/format-message.test.ts +47 -47
package/src/__tests__/jsonl-stream.test.ts +79 -79
package/src/__tests__/package-files.test.ts +24 -24
package/src/__tests__/privacy.test.ts +198 -198
package/src/__tests__/progress-reducer.test.ts +121 -110
package/src/__tests__/raw-stream-log.test.ts +106 -106
package/src/__tests__/response-stall.test.ts +49 -49
package/src/__tests__/session.test.ts +11 -16
package/src/__tests__/shared-prefix.test.ts +36 -36
package/src/__tests__/sim-platform.test.ts +16 -16
package/src/__tests__/startup-lifecycle.test.ts +231 -231
package/src/__tests__/stop-session.test.ts +34 -34
package/src/__tests__/stream-state.test.ts +42 -42
package/src/__tests__/terminal-renderer.test.ts +247 -247
package/src/__tests__/update-command-guard.test.ts +144 -144
package/src/__tests__/web-ui.test.ts +326 -326
package/src/adapters/adapter-interface.ts +24 -18
package/src/adapters/ccc-adapter.ts +141 -131
package/src/adapters/claude-adapter.ts +620 -620
package/src/adapters/claude-session-meta-store.ts +120 -120
package/src/adapters/codex-adapter.ts +426 -426
package/src/adapters/cursor-adapter.ts +681 -681
package/src/adapters/jsonl-stream.ts +157 -157
package/src/adapters/raw-stream-log.ts +124 -124
package/src/adapters/resource-monitor.ts +140 -140
package/src/agent-activity.ts +175 -170
package/src/agent-delegate-task-rpc.ts +153 -153
package/src/agent-delegate-task.ts +91 -91
package/src/agent-reload-config-rpc.ts +34 -34
package/src/agent-stop-stuck.ts +129 -129
package/src/builtin/cli.ts +9 -2
package/src/builtin/config.ts +84 -84
package/src/builtin/context.ts +62 -4
package/src/builtin/file-log.ts +38 -38
package/src/builtin/index.ts +83 -19
package/src/builtin/proc-tree-kill.ts +61 -61
package/src/builtin/progress/cards-helpers.ts +76 -76
package/src/builtin/progress/reducer.ts +113 -108
package/src/builtin/progress/terminal-renderer.ts +294 -294
package/src/builtin/progress/view.ts +77 -77
package/src/builtin/raw-stream-log.ts +124 -124
package/src/builtin/session-select.ts +48 -48
package/src/builtin/sigint.ts +50 -50
package/src/builtin/web-tools.ts +313 -313
package/src/card-action-routing.ts +14 -14
package/src/chatgpt-subscription-rpc.ts +27 -27
package/src/chatgpt-subscription.ts +299 -299
package/src/chrome-devtools-guard.ts +318 -318
package/src/codex-reset-actions.ts +184 -184
package/src/feishu-api.ts +193 -193
package/src/feishu-message-ingress.ts +195 -195
package/src/feishu-platform.ts +20 -20
package/src/format-message.ts +293 -293
package/src/litellm-proxy.ts +374 -374
package/src/platform-adapter.ts +6 -6
package/src/privacy.ts +118 -118
package/src/progress/reducer.ts +113 -108
package/src/progress/terminal-renderer.ts +294 -294
package/src/progress/view.ts +77 -77
package/src/response-stall.ts +28 -28
package/src/runtime-reload.ts +34 -34
package/src/session-chat-binding.ts +82 -82
package/src/session-name.ts +8 -8
package/src/session.ts +12 -11
package/src/shared-prefix.ts +29 -29
package/src/sim-platform.ts +20 -20
package/src/startup-lifecycle.ts +250 -250
package/src/turn-cards.ts +117 -117
package/src/update-command-guard.ts +165 -165

package/src/__tests__/builtin-sigint.test.ts CHANGED Viewed

@@ -1,56 +1,56 @@
-import { describe, expect, it } from "vitest";
-import { createCtrlCState } from "../builtin/sigint.ts";
-describe("builtin CLI Ctrl+C state", () => {
-  it("requires two presses to interrupt an active generation", () => {
-    let now = 1_000;
-    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
-    expect(state.press(true)).toBe("arm-interrupt");
-    expect(state.press(true)).toBe("interrupt");
-  });
-  it("requires two presses to exit while idle", () => {
-    let now = 1_000;
-    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
-    expect(state.press(false)).toBe("arm-exit");
-    expect(state.press(false)).toBe("exit");
-  });
-  it("expires the pending confirmation after the window", () => {
-    let now = 1_000;
-    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
-    expect(state.press(true)).toBe("arm-interrupt");
-    now += 2_001;
-    expect(state.press(true)).toBe("arm-interrupt");
-    expect(state.press(true)).toBe("interrupt");
-  });
-  it("does not convert a pending interrupt into an idle exit after reset", () => {
-    let now = 1_000;
-    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
-    expect(state.press(true)).toBe("arm-interrupt");
-    state.reset();
-    now += 1_000;
-    expect(state.press(false)).toBe("arm-exit");
-  });
-  it("does not confirm a different action with the second press", () => {
-    let now = 1_000;
-    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
-    expect(state.press(true)).toBe("arm-interrupt");
-    now += 500;
-    expect(state.press(false)).toBe("arm-exit");
-    expect(state.press(false)).toBe("exit");
-  });
-});
+import { describe, expect, it } from "vitest";
+import { createCtrlCState } from "../builtin/sigint.ts";
+describe("builtin CLI Ctrl+C state", () => {
+  it("requires two presses to interrupt an active generation", () => {
+    let now = 1_000;
+    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
+    expect(state.press(true)).toBe("arm-interrupt");
+    expect(state.press(true)).toBe("interrupt");
+  });
+  it("requires two presses to exit while idle", () => {
+    let now = 1_000;
+    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
+    expect(state.press(false)).toBe("arm-exit");
+    expect(state.press(false)).toBe("exit");
+  });
+  it("expires the pending confirmation after the window", () => {
+    let now = 1_000;
+    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
+    expect(state.press(true)).toBe("arm-interrupt");
+    now += 2_001;
+    expect(state.press(true)).toBe("arm-interrupt");
+    expect(state.press(true)).toBe("interrupt");
+  });
+  it("does not convert a pending interrupt into an idle exit after reset", () => {
+    let now = 1_000;
+    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
+    expect(state.press(true)).toBe("arm-interrupt");
+    state.reset();
+    now += 1_000;
+    expect(state.press(false)).toBe("arm-exit");
+  });
+  it("does not confirm a different action with the second press", () => {
+    let now = 1_000;
+    const state = createCtrlCState({ windowMs: 2_000, now: () => now });
+    expect(state.press(true)).toBe("arm-interrupt");
+    now += 500;
+    expect(state.press(false)).toBe("arm-exit");
+    expect(state.press(false)).toBe("exit");
+  });
+});

package/src/__tests__/builtin-web-tools.test.ts CHANGED Viewed

@@ -1,220 +1,220 @@
-import { describe, expect, it } from "vitest";
-import {
-  decodeDdgHref,
-  extractHtmlTitle,
-  htmlToPlainText,
-  parseDuckDuckGoHtml,
-  webFetchForTool,
-  webSearchForTool,
-  type FetchLike,
-} from "../builtin/web-tools.ts";
-const DDG_HTML = `<!DOCTYPE html>
-<html>
-<head><title>Search results</title></head>
-<body>
-  <div class="result results_links results_links_deep web-result">
-    <h2 class="result__title">
-      <a rel="nofollow" class="result__a" href="//duckduckgo.com/l/?uddg=https%3A%2F%2Fnodejs.org%2Fen%2Fdocs&rut=abc">Node.js <b>Docs</b></a>
-    </h2>
-    <a rel="nofollow" class="result__snippet" href="//duckduckgo.com/l/?uddg=...">Official documentation for Node.js &amp; npm.</a>
-  </div>
-  <div class="result">
-    <a rel="nofollow" class="result__a" href="https://example.com/page">Example &quot;quoted&quot; page</a>
-    <a rel="nofollow" class="result__snippet" href="https://example.com/page">A plain snippet without highlight.</a>
-  </div>
-</body>
-</html>`;
-const WEB_FETCH_HTML = `<!DOCTYPE html>
-<html><head><title>Fetch &amp; Me</title></head>
-<body>
-  <style>.x { color: red }</style>
-  <script>alert("x")</script>
-  <h1>Hello World</h1>
-  <p>First paragraph with &amp; entity.</p>
-  <p>Second paragraph<br>with a break.</p>
-  <footer>bye</footer>
-</body></html>`;
-describe("parseDuckDuckGoHtml", () => {
-  it("extracts title, decoded url, and snippet per result", () => {
-    const results = parseDuckDuckGoHtml(DDG_HTML);
-    expect(results).toHaveLength(2);
-    expect(results[0]).toEqual({
-      title: "Node.js Docs",
-      url: "https://nodejs.org/en/docs",
-      snippet: "Official documentation for Node.js & npm.",
-    });
-    expect(results[1]).toEqual({
-      title: 'Example "quoted" page',
-      url: "https://example.com/page",
-      snippet: "A plain snippet without highlight.",
-    });
-  });
-  it("returns empty array for pages without results", () => {
-    expect(parseDuckDuckGoHtml("<html><body>no results here</body></html>")).toEqual([]);
-  });
-});
-describe("decodeDdgHref", () => {
-  it("decodes uddg redirect params and restores protocol", () => {
-    expect(
-      decodeDdgHref("//duckduckgo.com/l/?uddg=https%3A%2F%2Fnodejs.org%2Fen%2Fdocs&rut=abc"),
-    ).toBe("https://nodejs.org/en/docs");
-  });
-  it("passes through plain urls", () => {
-    expect(decodeDdgHref("https://example.com/a?b=1")).toBe("https://example.com/a?b=1");
-  });
-  it("returns input untouched when unparseable", () => {
-    expect(decodeDdgHref("not a url")).toBe("not a url");
-  });
-});
-describe("htmlToPlainText", () => {
-  it("strips scripts/styles, keeps block boundaries, decodes entities, compresses whitespace", () => {
-    const text = htmlToPlainText(WEB_FETCH_HTML);
-    expect(text).not.toContain("alert");
-    expect(text).not.toContain(".x {");
-    expect(text).toContain("Hello World");
-    expect(text).toContain("First paragraph with & entity.");
-    expect(text).toContain("Second paragraph\nwith a break.");
-    expect(text).toContain("bye");
-    // 段落间允许单个空行，但不得出现连续空行
-    expect(text).not.toContain("\n\n\n");
-  });
-});
-describe("extractHtmlTitle", () => {
-  it("extracts and decodes the title", () => {
-    expect(extractHtmlTitle(WEB_FETCH_HTML)).toBe("Fetch & Me");
-  });
-  it("returns empty string when no title", () => {
-    expect(extractHtmlTitle("<html><body>x</body></html>")).toBe("");
-  });
-});
-describe("webSearchForTool", () => {
-  function mockFetch(html: string, status = 200): FetchLike {
-    return async () =>
-      new Response(html, {
-        status,
-        headers: { "content-type": "text/html; charset=utf-8" },
-      });
-  }
-  it("returns parsed results from the search page", async () => {
-    const output = await webSearchForTool(
-      { query: "nodejs docs" },
-      { fetchImpl: mockFetch(DDG_HTML) },
-    );
-    expect(output.query).toBe("nodejs docs");
-    expect(output.results).toHaveLength(2);
-    expect(output.results[0].url).toBe("https://nodejs.org/en/docs");
-    expect(output.results[0].snippet).toContain("Node.js");
-    expect(typeof output.durationMs).toBe("number");
-  });
-  it("respects maxResults and caps at 10", async () => {
-    const html = Array.from({ length: 12 }, (_, i) => {
-      const title = `<a rel="nofollow" class="result__a" href="https://e.com/${i}">R${i}</a>`;
-      const snippet = `<a rel="nofollow" class="result__snippet" href="https://e.com/${i}">s${i}</a>`;
-      return `<div>${title}${snippet}</div>`;
-    }).join("");
-    const output = await webSearchForTool({ query: "many" }, { fetchImpl: mockFetch(html) });
-    expect(output.results).toHaveLength(5);
-    expect(output.truncated).toBe(true);
-    const output2 = await webSearchForTool({ query: "many", maxResults: 20 }, { fetchImpl: mockFetch(html) });
-    expect(output2.results).toHaveLength(10);
-  });
-  it("returns empty results (not an error) when the page has no matches", async () => {
-    const output = await webSearchForTool(
-      { query: "zzz-nothing" },
-      { fetchImpl: mockFetch("<html><body>no results</body></html>") },
-    );
-    expect(output.results).toEqual([]);
-    expect(output.truncated).toBe(false);
-  });
-  it("throws on empty query", async () => {
-    await expect(webSearchForTool({ query: "  " }, { fetchImpl: mockFetch("") })).rejects.toThrow(
-      "query is required",
-    );
-  });
-  it("throws on non-2xx response", async () => {
-    await expect(
-      webSearchForTool({ query: "x" }, { fetchImpl: mockFetch("blocked", 429) }),
-    ).rejects.toThrow("HTTP 429");
-  });
-});
-describe("webFetchForTool", () => {
-  function mockFetch(html: string, status = 200, contentType = "text/html; charset=utf-8"): FetchLike {
-    return async () =>
-      new Response(html, {
-        status,
-        headers: { "content-type": contentType },
-      });
-  }
-  it("fetches and converts html to plain text with title", async () => {
-    const output = await webFetchForTool(
-      { url: "https://example.com/page" },
-      { fetchImpl: mockFetch(WEB_FETCH_HTML) },
-    );
-    expect(output.title).toBe("Fetch & Me");
-    expect(output.text).toContain("Hello World");
-    expect(output.text).toContain("Second paragraph\nwith a break.");
-    expect(output.text).not.toContain("alert");
-    expect(output.contentType).toContain("text/html");
-    expect(output.chars).toBe(output.text.length);
-    expect(output.truncated).toBe(false);
-  });
-  it("truncates text beyond maxChars", async () => {
-    const output = await webFetchForTool(
-      { url: "https://example.com/long", maxChars: 10 },
-      { fetchImpl: mockFetch("<p>hello world and more</p>") },
-    );
-    expect(output.text).toBe("hello worl");
-    expect(output.truncated).toBe(true);
-    expect(output.chars).toBe(10);
-  });
-  it("truncates oversized response bodies", async () => {
-    const big = `<!DOCTYPE html><html><body><p>${"a".repeat(600 * 1024)}</p></body></html>`;
-    const output = await webFetchForTool(
-      { url: "https://example.com/big" },
-      { fetchImpl: mockFetch(big) },
-    );
-    expect(output.truncated).toBe(true);
-    expect(output.text.length).toBeLessThan(600 * 1024);
-  });
-  it("rejects non-http(s) protocols", async () => {
-    await expect(
-      webFetchForTool({ url: "file:///etc/passwd" }, { fetchImpl: mockFetch("") }),
-    ).rejects.toThrow("unsupported protocol");
-  });
-  it("rejects invalid urls", async () => {
-    await expect(
-      webFetchForTool({ url: "not a url" }, { fetchImpl: mockFetch("") }),
-    ).rejects.toThrow("invalid URL");
-  });
-  it("throws on missing url and non-2xx", async () => {
-    await expect(webFetchForTool({ url: "  " })).rejects.toThrow("url is required");
-    await expect(
-      webFetchForTool({ url: "https://example.com/404" }, { fetchImpl: mockFetch("nf", 404) }),
-    ).rejects.toThrow("HTTP 404");
-  });
-});
+import { describe, expect, it } from "vitest";
+import {
+  decodeDdgHref,
+  extractHtmlTitle,
+  htmlToPlainText,
+  parseDuckDuckGoHtml,
+  webFetchForTool,
+  webSearchForTool,
+  type FetchLike,
+} from "../builtin/web-tools.ts";
+const DDG_HTML = `<!DOCTYPE html>
+<html>
+<head><title>Search results</title></head>
+<body>
+  <div class="result results_links results_links_deep web-result">
+    <h2 class="result__title">
+      <a rel="nofollow" class="result__a" href="//duckduckgo.com/l/?uddg=https%3A%2F%2Fnodejs.org%2Fen%2Fdocs&rut=abc">Node.js <b>Docs</b></a>
+    </h2>
+    <a rel="nofollow" class="result__snippet" href="//duckduckgo.com/l/?uddg=...">Official documentation for Node.js &amp; npm.</a>
+  </div>
+  <div class="result">
+    <a rel="nofollow" class="result__a" href="https://example.com/page">Example &quot;quoted&quot; page</a>
+    <a rel="nofollow" class="result__snippet" href="https://example.com/page">A plain snippet without highlight.</a>
+  </div>
+</body>
+</html>`;
+const WEB_FETCH_HTML = `<!DOCTYPE html>
+<html><head><title>Fetch &amp; Me</title></head>
+<body>
+  <style>.x { color: red }</style>
+  <script>alert("x")</script>
+  <h1>Hello World</h1>
+  <p>First paragraph with &amp; entity.</p>
+  <p>Second paragraph<br>with a break.</p>
+  <footer>bye</footer>
+</body></html>`;
+describe("parseDuckDuckGoHtml", () => {
+  it("extracts title, decoded url, and snippet per result", () => {
+    const results = parseDuckDuckGoHtml(DDG_HTML);
+    expect(results).toHaveLength(2);
+    expect(results[0]).toEqual({
+      title: "Node.js Docs",
+      url: "https://nodejs.org/en/docs",
+      snippet: "Official documentation for Node.js & npm.",
+    });
+    expect(results[1]).toEqual({
+      title: 'Example "quoted" page',
+      url: "https://example.com/page",
+      snippet: "A plain snippet without highlight.",
+    });
+  });
+  it("returns empty array for pages without results", () => {
+    expect(parseDuckDuckGoHtml("<html><body>no results here</body></html>")).toEqual([]);
+  });
+});
+describe("decodeDdgHref", () => {
+  it("decodes uddg redirect params and restores protocol", () => {
+    expect(
+      decodeDdgHref("//duckduckgo.com/l/?uddg=https%3A%2F%2Fnodejs.org%2Fen%2Fdocs&rut=abc"),
+    ).toBe("https://nodejs.org/en/docs");
+  });
+  it("passes through plain urls", () => {
+    expect(decodeDdgHref("https://example.com/a?b=1")).toBe("https://example.com/a?b=1");
+  });
+  it("returns input untouched when unparseable", () => {
+    expect(decodeDdgHref("not a url")).toBe("not a url");
+  });
+});
+describe("htmlToPlainText", () => {
+  it("strips scripts/styles, keeps block boundaries, decodes entities, compresses whitespace", () => {
+    const text = htmlToPlainText(WEB_FETCH_HTML);
+    expect(text).not.toContain("alert");
+    expect(text).not.toContain(".x {");
+    expect(text).toContain("Hello World");
+    expect(text).toContain("First paragraph with & entity.");
+    expect(text).toContain("Second paragraph\nwith a break.");
+    expect(text).toContain("bye");
+    // 段落间允许单个空行，但不得出现连续空行
+    expect(text).not.toContain("\n\n\n");
+  });
+});
+describe("extractHtmlTitle", () => {
+  it("extracts and decodes the title", () => {
+    expect(extractHtmlTitle(WEB_FETCH_HTML)).toBe("Fetch & Me");
+  });
+  it("returns empty string when no title", () => {
+    expect(extractHtmlTitle("<html><body>x</body></html>")).toBe("");
+  });
+});
+describe("webSearchForTool", () => {
+  function mockFetch(html: string, status = 200): FetchLike {
+    return async () =>
+      new Response(html, {
+        status,
+        headers: { "content-type": "text/html; charset=utf-8" },
+      });
+  }
+  it("returns parsed results from the search page", async () => {
+    const output = await webSearchForTool(
+      { query: "nodejs docs" },
+      { fetchImpl: mockFetch(DDG_HTML) },
+    );
+    expect(output.query).toBe("nodejs docs");
+    expect(output.results).toHaveLength(2);
+    expect(output.results[0].url).toBe("https://nodejs.org/en/docs");
+    expect(output.results[0].snippet).toContain("Node.js");
+    expect(typeof output.durationMs).toBe("number");
+  });
+  it("respects maxResults and caps at 10", async () => {
+    const html = Array.from({ length: 12 }, (_, i) => {
+      const title = `<a rel="nofollow" class="result__a" href="https://e.com/${i}">R${i}</a>`;
+      const snippet = `<a rel="nofollow" class="result__snippet" href="https://e.com/${i}">s${i}</a>`;
+      return `<div>${title}${snippet}</div>`;
+    }).join("");
+    const output = await webSearchForTool({ query: "many" }, { fetchImpl: mockFetch(html) });
+    expect(output.results).toHaveLength(5);
+    expect(output.truncated).toBe(true);
+    const output2 = await webSearchForTool({ query: "many", maxResults: 20 }, { fetchImpl: mockFetch(html) });
+    expect(output2.results).toHaveLength(10);
+  });
+  it("returns empty results (not an error) when the page has no matches", async () => {
+    const output = await webSearchForTool(
+      { query: "zzz-nothing" },
+      { fetchImpl: mockFetch("<html><body>no results</body></html>") },
+    );
+    expect(output.results).toEqual([]);
+    expect(output.truncated).toBe(false);
+  });
+  it("throws on empty query", async () => {
+    await expect(webSearchForTool({ query: "  " }, { fetchImpl: mockFetch("") })).rejects.toThrow(
+      "query is required",
+    );
+  });
+  it("throws on non-2xx response", async () => {
+    await expect(
+      webSearchForTool({ query: "x" }, { fetchImpl: mockFetch("blocked", 429) }),
+    ).rejects.toThrow("HTTP 429");
+  });
+});
+describe("webFetchForTool", () => {
+  function mockFetch(html: string, status = 200, contentType = "text/html; charset=utf-8"): FetchLike {
+    return async () =>
+      new Response(html, {
+        status,
+        headers: { "content-type": contentType },
+      });
+  }
+  it("fetches and converts html to plain text with title", async () => {
+    const output = await webFetchForTool(
+      { url: "https://example.com/page" },
+      { fetchImpl: mockFetch(WEB_FETCH_HTML) },
+    );
+    expect(output.title).toBe("Fetch & Me");
+    expect(output.text).toContain("Hello World");
+    expect(output.text).toContain("Second paragraph\nwith a break.");
+    expect(output.text).not.toContain("alert");
+    expect(output.contentType).toContain("text/html");
+    expect(output.chars).toBe(output.text.length);
+    expect(output.truncated).toBe(false);
+  });
+  it("truncates text beyond maxChars", async () => {
+    const output = await webFetchForTool(
+      { url: "https://example.com/long", maxChars: 10 },
+      { fetchImpl: mockFetch("<p>hello world and more</p>") },
+    );
+    expect(output.text).toBe("hello worl");
+    expect(output.truncated).toBe(true);
+    expect(output.chars).toBe(10);
+  });
+  it("truncates oversized response bodies", async () => {
+    const big = `<!DOCTYPE html><html><body><p>${"a".repeat(600 * 1024)}</p></body></html>`;
+    const output = await webFetchForTool(
+      { url: "https://example.com/big" },
+      { fetchImpl: mockFetch(big) },
+    );
+    expect(output.truncated).toBe(true);
+    expect(output.text.length).toBeLessThan(600 * 1024);
+  });
+  it("rejects non-http(s) protocols", async () => {
+    await expect(
+      webFetchForTool({ url: "file:///etc/passwd" }, { fetchImpl: mockFetch("") }),
+    ).rejects.toThrow("unsupported protocol");
+  });
+  it("rejects invalid urls", async () => {
+    await expect(
+      webFetchForTool({ url: "not a url" }, { fetchImpl: mockFetch("") }),
+    ).rejects.toThrow("invalid URL");
+  });
+  it("throws on missing url and non-2xx", async () => {
+    await expect(webFetchForTool({ url: "  " })).rejects.toThrow("url is required");
+    await expect(
+      webFetchForTool({ url: "https://example.com/404" }, { fetchImpl: mockFetch("nf", 404) }),
+    ).rejects.toThrow("HTTP 404");
+  });
+});

package/src/__tests__/card-action-routing.test.ts CHANGED Viewed

@@ -1,18 +1,18 @@
-import { describe, expect, it } from "vitest";
-import { resolveFeishuCardActionChatType } from "../card-action-routing.ts";
-describe("resolveFeishuCardActionChatType", () => {
-  it("keeps card commands in a persisted private chat on the p2p route", () => {
-    expect(resolveFeishuCardActionChatType("private-chat", {
-      "private-chat": { chatType: "p2p" },
-    })).toBe("p2p");
-  });
-  it("defaults unknown and group chats to the group route", () => {
-    expect(resolveFeishuCardActionChatType("group-chat", {
-      "group-chat": { chatType: "group" },
-    })).toBe("group");
-    expect(resolveFeishuCardActionChatType("unknown-chat", {})).toBe("group");
-  });
-});
+import { describe, expect, it } from "vitest";
+import { resolveFeishuCardActionChatType } from "../card-action-routing.ts";
+describe("resolveFeishuCardActionChatType", () => {
+  it("keeps card commands in a persisted private chat on the p2p route", () => {
+    expect(resolveFeishuCardActionChatType("private-chat", {
+      "private-chat": { chatType: "p2p" },
+    })).toBe("p2p");
+  });
+  it("defaults unknown and group chats to the group route", () => {
+    expect(resolveFeishuCardActionChatType("group-chat", {
+      "group-chat": { chatType: "group" },
+    })).toBe("group");
+    expect(resolveFeishuCardActionChatType("unknown-chat", {})).toBe("group");
+  });
+});