npm - chatccc - Versions diffs - 0.2.241 → 0.2.242 - Mend

chatccc 0.2.241 → 0.2.242

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 (58) hide show

package/deepccc-agent/src/__tests__/web-tools.test.ts ADDED Viewed

@@ -0,0 +1,220 @@
+import { describe, expect, it } from "vitest";
+import {
+  decodeDdgHref,
+  extractHtmlTitle,
+  htmlToPlainText,
+  parseDuckDuckGoHtml,
+  webFetchForTool,
+  webSearchForTool,
+  type FetchLike,
+} from "../web-tools.js";
+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/deepccc-agent/tsconfig.build.json ADDED Viewed

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": false,
+    "sourceMap": false
+  },
+  "include": ["src/*.ts"],
+  "exclude": ["src/__tests__/**"]
+}

package/deepccc-agent/tsconfig.json ADDED Viewed

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "noEmit": true
+  },
+  "include": ["src/**/*.ts", "vitest.config.ts"]
+}

package/deepccc-agent/vitest.config.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import { defineConfig } from "vitest/config";
+export default defineConfig({
+  test: {
+    include: ["src/__tests__/**/*.test.ts"],
+  },
+});

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.241",
+  "version": "0.2.242",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",
@@ -11,6 +11,7 @@
   },
   "files": [
     "src/",
+    "deepccc-agent/",
     "bin/",
     "scripts/postinstall-sharp-check.mjs",
     "demo/ilink_echo_probe.ts",
@@ -43,6 +44,7 @@
     "demo:ilink-echo": "tsx demo/ilink_echo_probe.ts",
     "claude-proxy": "tsx src/litellm-proxy.ts",
     "test": "vitest run",
+    "test:deepccc": "vitest run --root deepccc-agent",
     "test:watch": "vitest",
     "postinstall": "node scripts/postinstall-sharp-check.mjs"
   },

package/src/__tests__/builtin-chat-session.test.ts CHANGED Viewed

@@ -4,8 +4,8 @@ import { join } from "node:path";
 import { afterEach, describe, expect, it, vi } from "vitest";
-import { config } from "../builtin/config.ts";
-import { estimateBuiltinContextTokens } from "../builtin/context.ts";
+import { config } from "../../deepccc-agent/src/config.ts";
+import { estimateBuiltinContextTokens } from "../../deepccc-agent/src/context.ts";
 const streamTextMock = vi.fn();
 const generateTextMock = vi.fn();
@@ -27,7 +27,7 @@ vi.mock("ai", () => ({
   tool: vi.fn((definition: unknown) => definition),
 }));
-vi.mock("../builtin/raw-stream-log.js", () => ({
+vi.mock("../../deepccc-agent/src/raw-stream-log.js", () => ({
   createRawStreamLog: createRawStreamLogMock,
 }));
@@ -57,7 +57,7 @@ afterEach(() => {
 describe("ChatSession context management", () => {
   it("keeps the generalized evidence gate in the stable system prompt prefix", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-evidence-gate-"));
     await writeFile(join(dir, "AGENTS.md"), "PROJECT GUIDANCE MARKER", "utf-8");
     streamTextMock.mockReturnValueOnce({ textStream: textStream("done") });
@@ -93,7 +93,7 @@ describe("ChatSession context management", () => {
   });
   it("keeps execution discipline sections in the stable system prompt prefix", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-discipline-"));
     await writeFile(join(dir, "AGENTS.md"), "PROJECT GUIDANCE MARKER", "utf-8");
     streamTextMock.mockReturnValueOnce({ textStream: textStream("done") });
@@ -130,7 +130,7 @@ describe("ChatSession context management", () => {
   });
   it("injects cwd project instruction files before runtime workspace details", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-instructions-"));
     await writeFile(join(dir, "AGENTS.md"), "agents root guidance", "utf-8");
     await writeFile(join(dir, "AGENTS.local.md"), "agents local guidance", "utf-8");
@@ -165,7 +165,7 @@ describe("ChatSession context management", () => {
   });
   it("places the volatile skills index at the very end of system prompt", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-skill-order-"));
     const skillsDir = join(dir, "skills");
     await mkdir(join(skillsDir, "demo-skill"), { recursive: true });
@@ -199,7 +199,7 @@ describe("ChatSession context management", () => {
   });
   it("does not read project instruction files from parent directories", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const parent = await mkdtemp(join(tmpdir(), "deepccc-session-parent-instructions-"));
     const child = join(parent, "child");
     await mkdir(child);
@@ -220,7 +220,7 @@ describe("ChatSession context management", () => {
   });
   it("uses loop-finished stopping by default", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-unlimited-"));
     streamTextMock.mockReturnValueOnce({ textStream: textStream("done") });
@@ -239,7 +239,7 @@ describe("ChatSession context management", () => {
   });
   it("uses a configured tool step limit when provided", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-step-budget-"));
     streamTextMock.mockReturnValueOnce({ textStream: textStream("done") });
@@ -259,7 +259,7 @@ describe("ChatSession context management", () => {
   });
   it("loads persisted context, compacts older messages, and persists the new assistant reply", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-context-"));
     const seed = new ChatSession(
@@ -307,7 +307,7 @@ describe("ChatSession context management", () => {
   it("times out context compaction independently before reply generation", async () => {
     vi.useFakeTimers();
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-compaction-timeout-"));
     const seed = new ChatSession(
       { apiKey: "sk-test" },
@@ -341,7 +341,7 @@ describe("ChatSession context management", () => {
   });
   it("streams tool calls and tool results from fullStream", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-tools-"));
     const session = new ChatSession(
       { apiKey: "sk-test" },
@@ -379,7 +379,7 @@ describe("ChatSession context management", () => {
   });
   it("caps the total persisted tool transcript for a turn", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-tool-cap-"));
     const session = new ChatSession(
       { apiKey: "sk-test" },
@@ -403,7 +403,7 @@ describe("ChatSession context management", () => {
   });
   it("persists structured tool calls alongside the text transcript", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-structured-tools-"));
     const session = new ChatSession(
       { apiKey: "sk-test" },
@@ -430,7 +430,7 @@ describe("ChatSession context management", () => {
   });
   it("records tool errors and preserves tool call order in structured tool calls", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     const dir = await mkdtemp(join(tmpdir(), "deepccc-session-structured-tools-order-"));
     const session = new ChatSession(
       { apiKey: "sk-test" },
@@ -459,7 +459,7 @@ describe("ChatSession context management", () => {
   });
   it("writes raw DeepCCC fullStream parts when raw stream logs are enabled", async () => {
-    const { ChatSession } = await import("../builtin/index.ts");
+    const { ChatSession } = await import("../../deepccc-agent/src/index.ts");
     config.rawStreamLogs = {
       enabled: true,
       maxBytesPerTurn: 4096,

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

@@ -1,7 +1,7 @@
 import { afterEach, describe, expect, it } from "vitest";
-import { ChatSession } from "../builtin/index.ts";
-import { config } from "../builtin/config.ts";
+import { ChatSession } from "../../deepccc-agent/src/index.ts";
+import { config } from "../../deepccc-agent/src/config.ts";
 const originalDeepSeekApiKey = process.env.DEEPSEEK_API_KEY;
 const originalDeepCccApiKey = config.apiKey;

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

@@ -12,7 +12,7 @@ import {
   listBuiltinContextSessions,
   newBuiltinSessionId,
   serializeMessagesForSummary,
-} from "../builtin/context.ts";
+} from "../../deepccc-agent/src/context.ts";
 describe("BuiltinContextManager", () => {
   it("keeps recent messages within the token budget instead of a fixed count", () => {

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

@@ -18,7 +18,7 @@ import {
   readFileForTool,
   runCommandForTool,
   searchCodeForTool,
-} from "../builtin/file-tools.ts";
+} from "../../deepccc-agent/src/file-tools.ts";
 const execFileAsync = promisify(execFile);
 const tempDirs: string[] = [];

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

@@ -31,7 +31,7 @@ vi.mock("ai", () => ({
   tool: vi.fn((definition: unknown) => definition),
 }));
-vi.mock("../builtin/raw-stream-log.ts", () => ({
+vi.mock("../../deepccc-agent/src/raw-stream-log.ts", () => ({
   createRawStreamLog: vi.fn().mockResolvedValue(null),
 }));
@@ -41,9 +41,9 @@ import {
   isDangerousCommand,
   matchRule,
   reloadAllowRules,
-} from "../builtin/permissions.ts";
-import { createBuiltinFileTools } from "../builtin/file-tools.ts";
-import { ChatSession } from "../builtin/index.ts";
+} from "../../deepccc-agent/src/permissions.ts";
+import { createBuiltinFileTools } from "../../deepccc-agent/src/file-tools.ts";
+import { ChatSession } from "../../deepccc-agent/src/index.ts";
 const streamTextMock = aiMocks.streamText;
 const generateTextMock = aiMocks.generateText;

package/src/__tests__/builtin-session-search.test.ts CHANGED Viewed

@@ -5,7 +5,7 @@ import { gzipSync } from "node:zlib";
 import { describe, expect, it } from "vitest";
-import { searchBuiltinSessions } from "../builtin/session-search.ts";
+import { searchBuiltinSessions } from "../../deepccc-agent/src/session-search.ts";
 interface TestMessage {
   role: "user" | "assistant";

package/src/__tests__/builtin-session-select.test.ts CHANGED Viewed

@@ -4,8 +4,8 @@ import { join } from "node:path";
 import { describe, expect, it } from "vitest";
-import { defaultBuiltinSessionId } from "../builtin/context.ts";
-import { resolveBuiltinSession } from "../builtin/session-select.ts";
+import { defaultBuiltinSessionId } from "../../deepccc-agent/src/context.ts";
+import { resolveBuiltinSession } from "../../deepccc-agent/src/session-select.ts";
 async function writeSession(
   contextDir: string,

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

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
-import { createCtrlCState } from "../builtin/sigint.ts";
+import { createCtrlCState } from "../../deepccc-agent/src/sigint.ts";
 describe("builtin CLI Ctrl+C state", () => {
   it("requires two presses to interrupt an active generation", () => {

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

@@ -13,7 +13,7 @@ import {
   type SkillDirSpec,
   type SkillSource,
   type SkillScope,
-} from "../builtin/skills.ts";
+} from "../../deepccc-agent/src/skills.ts";
 let tempRoot: string;

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

@@ -8,7 +8,7 @@ import {
   webFetchForTool,
   webSearchForTool,
   type FetchLike,
-} from "../builtin/web-tools.ts";
+} from "../../deepccc-agent/src/web-tools.ts";
 const DDG_HTML = `<!DOCTYPE html>
 <html>

package/src/__tests__/progress-reducer.test.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
-import type { ChatEvent } from "../builtin/index.ts";
+import type { ChatEvent } from "../../deepccc-agent/src/index.ts";
 import { reduceProgress, summarizeToolInput, summarizeToolResult } from "../progress/reducer.ts";
 import { progressView } from "../progress/view.ts";

package/src/adapters/ccc-adapter.ts CHANGED Viewed

@@ -1,9 +1,9 @@
-import { ChatSession, type ChatSessionConfig, type ChatSessionOptions } from "../builtin/index.ts";
+import { ChatSession, type ChatSessionConfig, type ChatSessionOptions } from "../../deepccc-agent/src/index.ts";
 import {
   getBuiltinContextSession,
   newBuiltinSessionId,
   normalizeBuiltinSessionId,
-} from "../builtin/context.ts";
+} from "../../deepccc-agent/src/context.ts";
 import { config, CCC_SESSION_PREFIX } from "../config.ts";
 import type {
   CreateSessionResult,

package/src/progress/reducer.ts CHANGED Viewed

@@ -7,7 +7,7 @@
  * 看到的过程状态（正文累积、工具调用、终态判定）完全一致。
  */
-import type { ChatEvent } from "../builtin/index.ts";
+import type { ChatEvent } from "../../deepccc-agent/src/index.ts";
 import {
   withProgressView,
   type ProgressToolCall,