@tachu/extensions 1.0.0-alpha.1

package/dist/tools/web-fetch/executor.js

@@ -0,0 +1,191 @@
+import { getMalformedResponseError, getNetworkError, getTimeoutError, mapServerErrorToClient, } from "./errors";
+import { assertNotAborted } from "../shared";
+let warnedMissingEndpoint = false;
+function getEndpointBase() {
+    const raw = process.env.TACHU_WEB_FETCH_ENDPOINT?.trim();
+    if (!raw) {
+        if (!warnedMissingEndpoint) {
+            warnedMissingEndpoint = true;
+            console.warn("[@tachu/extensions/web-fetch] TACHU_WEB_FETCH_ENDPOINT is not set; using default http://127.0.0.1:8787");
+        }
+        return "http://127.0.0.1:8787";
+    }
+    return raw.replace(/\/$/, "");
+}
+function readClientTimeoutMs(input) {
+    if (input.timeoutMs != null)
+        return input.timeoutMs;
+    const raw = process.env.TACHU_WEB_FETCH_TIMEOUT_MS?.trim();
+    if (!raw)
+        return 70000;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : 70000;
+}
+function toExtractRequest(input) {
+    const { timeoutMs: _timeoutMs, ...rest } = input;
+    return {
+        ...rest,
+        traceId: null,
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isExtractResponse(value) {
+    if (!isRecord(value))
+        return false;
+    const keys = [
+        "url",
+        "finalUrl",
+        "status",
+        "renderedWith",
+        "renderedAtMs",
+        "body",
+        "wordCount",
+        "truncated",
+        "warnings",
+        "traceId",
+    ];
+    for (const k of keys) {
+        if (!(k in value))
+            return false;
+    }
+    if (typeof value.url !== "string")
+        return false;
+    if (typeof value.finalUrl !== "string")
+        return false;
+    if (typeof value.status !== "number")
+        return false;
+    if (value.renderedWith !== "static" && value.renderedWith !== "browser")
+        return false;
+    if (typeof value.renderedAtMs !== "number")
+        return false;
+    if (typeof value.body !== "string")
+        return false;
+    if (typeof value.wordCount !== "number")
+        return false;
+    if (typeof value.truncated !== "boolean")
+        return false;
+    if (!Array.isArray(value.warnings))
+        return false;
+    if (typeof value.traceId !== "string")
+        return false;
+    return true;
+}
+function toToolOutput(res) {
+    const out = {
+        url: res.url,
+        finalUrl: res.finalUrl,
+        status: res.status,
+        renderedWith: res.renderedWith,
+        body: res.body,
+        wordCount: res.wordCount,
+        truncated: res.truncated,
+        warnings: res.warnings,
+    };
+    if (res.title !== undefined)
+        out.title = res.title;
+    if (res.description !== undefined)
+        out.description = res.description;
+    if (res.siteName !== undefined)
+        out.siteName = res.siteName;
+    if (res.lang !== undefined)
+        out.lang = res.lang;
+    if (res.byline !== undefined)
+        out.byline = res.byline;
+    if (res.publishedTime !== undefined)
+        out.publishedTime = res.publishedTime;
+    if (res.links !== undefined) {
+        out.links = res.links.map((l) => ({ text: l.text, href: l.href }));
+    }
+    if (res.images !== undefined) {
+        out.images = res.images.map((im) => ({ alt: im.alt, src: im.src }));
+    }
+    if (res.structured !== undefined)
+        out.structured = res.structured;
+    return out;
+}
+function tryParseErrorBody(text) {
+    try {
+        const parsed = JSON.parse(text);
+        if (!isRecord(parsed))
+            return null;
+        const err = parsed.error;
+        if (!isRecord(err))
+            return null;
+        if (typeof err.code !== "string")
+            return null;
+        if (typeof err.message !== "string")
+            return null;
+        if (typeof err.requestId !== "string")
+            return null;
+        const body = {
+            error: {
+                code: err.code,
+                message: err.message,
+                requestId: err.requestId,
+                ...(isRecord(err.detail) ? { detail: err.detail } : {}),
+            },
+        };
+        return body;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 调用 Web Fetch Server `/v1/extract`，返回正文与元数据。
+ *
+ * @see docs/adr/decisions/0003c-web-fetch-config.md §5.1
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md §4
+ */
+export async function executeWebFetch(input, ctx) {
+    assertNotAborted(ctx.abortSignal);
+    const endpoint = getEndpointBase();
+    const url = `${endpoint}/v1/extract`;
+    const timeoutMs = readClientTimeoutMs(input);
+    const signal = AbortSignal.any([AbortSignal.timeout(timeoutMs), ctx.abortSignal]);
+    const headers = {
+        "Content-Type": "application/json; charset=utf-8",
+    };
+    const token = process.env.TACHU_WEB_FETCH_TOKEN?.trim();
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(toExtractRequest(input)),
+            signal,
+        });
+    }
+    catch (e) {
+        if (e instanceof Error && e.name === "AbortError") {
+            if (ctx.abortSignal.aborted) {
+                throw ctx.abortSignal.reason ?? e;
+            }
+            throw getTimeoutError(timeoutMs);
+        }
+        throw getNetworkError(endpoint, e);
+    }
+    if (!response.ok) {
+        const text = await response.text();
+        const parsed = tryParseErrorBody(text);
+        throw mapServerErrorToClient(response.status, parsed, { endpoint });
+    }
+    const text = await response.text();
+    let parsedBody;
+    try {
+        parsedBody = JSON.parse(text);
+    }
+    catch {
+        throw getMalformedResponseError();
+    }
+    if (!isExtractResponse(parsedBody)) {
+        throw getMalformedResponseError();
+    }
+    return toToolOutput(parsedBody);
+}
+//# sourceMappingURL=executor.js.map

package/dist/tools/web-fetch/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/tools/web-fetch/executor.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-fetch/index.d.ts

@@ -0,0 +1,4 @@
+export { executeWebFetch } from "./executor";
+export { WebFetchClientError, type WebFetchClientErrorCode, type WebFetchClientOnlyErrorCode, } from "./errors";
+export type { CookieInit, ErrorResponseBody, ExtractRequest, ExtractResponse, ImageRef, LinkRef, OutputFormat, RenderMode, ResourceType, ScrollStrategy, WaitStrategy, WebFetchErrorCode, WebFetchToolInput, WebFetchToolOutput, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/web-fetch/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/web-fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,mBAAmB,EACnB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,GACjC,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/tools/web-fetch/index.js

@@ -0,0 +1,3 @@
+export { executeWebFetch } from "./executor";
+export { WebFetchClientError, } from "./errors";
+//# sourceMappingURL=index.js.map

package/dist/tools/web-fetch/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/web-fetch/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EACL,mBAAmB,GAGpB,MAAM,UAAU,CAAC"}

package/dist/tools/web-fetch/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Web Fetch 工具与 `/v1/extract` 共享的类型（客户端本地复刻，不依赖 `@tachu/web-fetch-server`）。
+ *
+ * @see docs/adr/decisions/0003b-web-fetch-types.md
+ */
+/**
+ * POST /v1/extract 请求体。
+ * @see docs/adr/decisions/0003a-web-fetch-api-contract.md §Endpoint 2 请求 schema
+ */
+export interface ExtractRequest {
+    url: string;
+    renderMode?: RenderMode;
+    waitFor?: WaitStrategy;
+    waitTimeoutMs?: number;
+    scroll?: ScrollStrategy;
+    userAgent?: string | null;
+    extraHeaders?: Record<string, string>;
+    cookies?: CookieInit[];
+    blockResources?: ResourceType[];
+    stealth?: boolean | null;
+    outputFormat?: OutputFormat;
+    includeLinks?: boolean;
+    includeImages?: boolean;
+    includeStructured?: boolean;
+    maxBodyChars?: number;
+    traceId?: string | null;
+}
+export type RenderMode = "static" | "browser" | "auto";
+export type WaitStrategy = "load" | "domcontentloaded" | "networkidle" | {
+    selector: string;
+} | {
+    timeMs: number;
+};
+export type ScrollStrategy = false | true | {
+    steps: number;
+    delayMs: number;
+};
+export interface CookieInit {
+    name: string;
+    value: string;
+    domain: string;
+    path?: string;
+    expires?: number;
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: "Strict" | "Lax" | "None";
+}
+export type ResourceType = "image" | "font" | "media" | "stylesheet" | "other";
+export type OutputFormat = "markdown" | "text" | "html" | "structured";
+/**
+ * POST /v1/extract 成功响应体。
+ * @see docs/adr/decisions/0003a-web-fetch-api-contract.md §Endpoint 2 响应 schema
+ */
+export interface ExtractResponse {
+    url: string;
+    finalUrl: string;
+    status: number;
+    renderedWith: "static" | "browser";
+    renderedAtMs: number;
+    title?: string;
+    description?: string;
+    siteName?: string;
+    lang?: string;
+    byline?: string;
+    publishedTime?: string | null;
+    body: string;
+    wordCount: number;
+    truncated: boolean;
+    links?: LinkRef[];
+    images?: ImageRef[];
+    structured?: Record<string, unknown>;
+    warnings: string[];
+    traceId: string;
+}
+export interface LinkRef {
+    text: string;
+    href: string;
+}
+export interface ImageRef {
+    alt: string;
+    src: string;
+    width?: number;
+    height?: number;
+}
+/**
+ * `web-fetch` 工具入参（与 server 侧 {@link ExtractRequest} 字段对齐；`timeoutMs` 仅客户端使用）。
+ * @see docs/adr/decisions/0003b-web-fetch-types.md §6.1
+ */
+export interface WebFetchToolInput {
+    url: string;
+    renderMode?: "static" | "browser" | "auto";
+    waitFor?: "load" | "domcontentloaded" | "networkidle" | {
+        selector: string;
+    } | {
+        timeMs: number;
+    };
+    waitTimeoutMs?: number;
+    scroll?: boolean | {
+        steps: number;
+        delayMs: number;
+    };
+    outputFormat?: "markdown" | "text" | "html" | "structured";
+    includeLinks?: boolean;
+    includeImages?: boolean;
+    includeStructured?: boolean;
+    maxBodyChars?: number;
+    stealth?: boolean | null;
+    /** client 端整体超时；默认与 `TACHU_WEB_FETCH_TIMEOUT_MS` 或 70000 对齐 */
+    timeoutMs?: number;
+}
+/**
+ * `web-fetch` 工具成功出参（不含服务端追踪字段）。
+ * @see docs/adr/decisions/0003b-web-fetch-types.md §6.1
+ */
+export interface WebFetchToolOutput {
+    url: string;
+    finalUrl: string;
+    status: number;
+    renderedWith: "static" | "browser";
+    title?: string;
+    description?: string;
+    siteName?: string;
+    lang?: string;
+    byline?: string;
+    publishedTime?: string | null;
+    body: string;
+    wordCount: number;
+    truncated: boolean;
+    links?: Array<{
+        text: string;
+        href: string;
+    }>;
+    images?: Array<{
+        alt: string;
+        src: string;
+    }>;
+    structured?: Record<string, unknown>;
+    warnings: string[];
+}
+/**
+ * 统一错误响应体结构。
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md
+ */
+export interface ErrorResponseBody {
+    error: {
+        code: WebFetchErrorCode;
+        message: string;
+        detail?: Record<string, unknown>;
+        requestId: string;
+    };
+}
+/**
+ * 所有错误码的字面量联合类型。
+ * @see docs/adr/decisions/0003b-web-fetch-types.md §4
+ */
+export type WebFetchErrorCode = "INVALID_REQUEST" | "INVALID_URL" | "UNAUTHORIZED" | "FORBIDDEN" | "SSRF_BLOCKED" | "DOMAIN_NOT_ALLOWED" | "REQUEST_TIMEOUT" | "REQUEST_TOO_LARGE" | "RESPONSE_TOO_LARGE" | "RENDER_FAILED" | "RATE_LIMITED" | "INTERNAL_ERROR" | "UPSTREAM_ERROR" | "BROWSER_POOL_EXHAUSTED" | "BROWSER_CRASHED" | "PROVIDER_NOT_CONFIGURED" | "PROVIDER_UPSTREAM_ERROR" | "PROVIDER_TIMEOUT" | "TIMEOUT_WEB_FETCH" | "TIMEOUT_WEB_SEARCH" | "WEB_FETCH_SERVER_UNREACHABLE" | "WEB_FETCH_ENDPOINT_NOT_CONFIGURED";
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/web-fetch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/web-fetch/types.ts"],"names":[],"mappings":"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"}

package/dist/tools/web-fetch/types.js

@@ -0,0 +1,7 @@
+/**
+ * Web Fetch 工具与 `/v1/extract` 共享的类型（客户端本地复刻，不依赖 `@tachu/web-fetch-server`）。
+ *
+ * @see docs/adr/decisions/0003b-web-fetch-types.md
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/web-fetch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/web-fetch/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/tools/web-search/descriptor.md

@@ -0,0 +1,89 @@
+---
+kind: tool
+id: web-search
+name: web-search
+version: "0.1.0"
+category: "web"
+dangerous: false
+description: |
+  通过 @tachu/web-fetch-server 调用 POST /v1/search：服务端编排搜索 provider 与可选的 top-N 网页抽取。**v0.1 默认 provider 为 stub**：在未正确配置真实搜索提供方与 API 密钥前，调用将返回 HTTP 503 与错误码 PROVIDER_NOT_CONFIGURED；运维需在服务端设置 WEB_SEARCH_PROVIDER、WEB_SEARCH_PROVIDER_API_KEY 等环境变量后方可获得真实结果。
+sideEffect: readonly
+idempotent: false
+requiresApproval: false
+timeout: 120000
+inputSchema:
+  type: object
+  properties:
+    query:
+      type: string
+      description: 搜索查询词（必填）
+    maxResults:
+      type: number
+      description: 返回条数；默认 10，上限 30（由服务端校验）
+    language:
+      type: string
+      description: 搜索语言偏好；省略由 provider 决定
+    region:
+      type: string
+      description: 地区偏好；省略由 provider 决定
+    timeRange:
+      type: string
+      enum: [day, week, month, year]
+      description: 时间范围过滤
+    safeSearch:
+      type: string
+      enum: [off, moderate, strict]
+      description: 安全搜索级别；默认 moderate
+    includeDomains:
+      type: array
+      items:
+        type: string
+      description: 仅包含这些域名
+    excludeDomains:
+      type: array
+      items:
+        type: string
+      description: 排除域名
+    fetchTopN:
+      type: number
+      description: 对前 N 条结果执行抽取；0 表示不抽取；上限 5
+    fetchOptions:
+      type: object
+      description: fetchTopN > 0 时透传至抽取管线（如 renderMode、maxBodyChars）
+      additionalProperties: true
+    timeoutMs:
+      type: number
+      description: 客户端整体超时毫秒数；默认与 TACHU_WEB_FETCH_TIMEOUT_MS 或 70000 对齐
+  required: [query]
+outputSchema:
+  type: object
+  description: 对应 POST /v1/search 200 响应（省略 searchedAtMs、traceId 等追踪字段）
+  properties:
+    query:
+      type: string
+    provider:
+      type: string
+    results:
+      type: array
+    totalResults:
+      type: number
+    warnings:
+      type: array
+      items:
+        type: string
+execute: web-search
+---
+
+## 行为说明
+
+- **Endpoint**：与 `web-fetch` 相同，使用 `TACHU_WEB_FETCH_ENDPOINT`（默认 `http://127.0.0.1:8787`），路径为 `/v1/search`。
+- **鉴权**：可选 `TACHU_WEB_FETCH_TOKEN`，以 `Authorization: Bearer` 发送。
+- **占位行为**：Stage 4 不提供真实第三方搜索；默认 stub 将返回「提供方未配置」，客户端会抛出带中文运维指引的错误。
+
+## 与 `web-fetch` 的关系
+
+| 维度 | web-search | web-fetch |
+| --- | --- | --- |
+| 能力 | 搜索 + 可选批量抽取 top-N | 单 URL 抽取 / 渲染 |
+| 端点 | `/v1/search` | `/v1/extract` |
+| v0.1 风险 | 默认 PROVIDER_NOT_CONFIGURED | 需可用渲染服务与 SSRF 策略 |

package/dist/tools/web-search/errors.d.ts

@@ -0,0 +1,33 @@
+import { WebFetchClientError, type WebFetchClientErrorCode } from "../web-fetch/errors";
+import type { ErrorResponseBody } from "../web-fetch/types";
+/**
+ * `web-search` 工具在客户端抛出的错误类型（语义上与 {@link ../web-fetch/errors.WebFetchClientError} 一致）。
+ *
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2 / §4
+ */
+export declare class WebSearchClientError extends Error {
+    readonly code: WebFetchClientErrorCode;
+    readonly userMessage: string;
+    readonly detail?: unknown | undefined;
+    readonly name = "WebSearchClientError";
+    constructor(code: WebFetchClientErrorCode, userMessage: string, detail?: unknown | undefined, options?: {
+        cause?: unknown;
+    });
+}
+/**
+ * 将 `/v1/search` 的错误响应映射为 {@link WebSearchClientError}。
+ * 对 `PROVIDER_NOT_CONFIGURED`（503）提供面向运维的中文指引。
+ *
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2
+ */
+export declare function mapSearchServerErrorToClient(httpStatus: number, body: ErrorResponseBody | null, ctx: {
+    endpoint: string;
+}): WebSearchClientError;
+/**
+ * 客户端整体超时（`TIMEOUT_WEB_SEARCH`）。
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.3
+ */
+export declare function getSearchTimeoutError(timeoutMs: number): WebSearchClientError;
+/** 将 {@link WebFetchClientError} 转为本工具统一抛出的错误类型。 */
+export declare function asWebSearchClientError(err: WebFetchClientError): WebSearchClientError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/tools/web-search/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,EACnB,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAI3B,IAAI,EAAE,uBAAuB;aAC7B,WAAW,EAAE,MAAM;aACnB,MAAM,CAAC,EAAE,OAAO;IALlC,QAAQ,CAAC,IAAI,0BAA0B;gBAGrB,IAAI,EAAE,uBAAuB,EAC7B,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,OAAO,YAAA,EAChC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIhC;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,iBAAiB,GAAG,IAAI,EAC9B,GAAG,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACxB,oBAAoB,CAatB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAM7E;AAED,oDAAoD;AACpD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,GAAG,oBAAoB,CAErF"}

package/dist/tools/web-search/errors.js

@@ -0,0 +1,45 @@
+import { mapServerErrorToClient, } from "../web-fetch/errors";
+/**
+ * `web-search` 工具在客户端抛出的错误类型（语义上与 {@link ../web-fetch/errors.WebFetchClientError} 一致）。
+ *
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2 / §4
+ */
+export class WebSearchClientError extends Error {
+    code;
+    userMessage;
+    detail;
+    name = "WebSearchClientError";
+    constructor(code, userMessage, detail, options) {
+        super(userMessage, options);
+        this.code = code;
+        this.userMessage = userMessage;
+        this.detail = detail;
+    }
+}
+/**
+ * 将 `/v1/search` 的错误响应映射为 {@link WebSearchClientError}。
+ * 对 `PROVIDER_NOT_CONFIGURED`（503）提供面向运维的中文指引。
+ *
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2
+ */
+export function mapSearchServerErrorToClient(httpStatus, body, ctx) {
+    const mapped = mapServerErrorToClient(httpStatus, body, ctx);
+    if (mapped.code === "PROVIDER_NOT_CONFIGURED") {
+        return new WebSearchClientError("PROVIDER_NOT_CONFIGURED", "搜索提供方未配置。请在服务器端设置 WEB_SEARCH_PROVIDER、WEB_SEARCH_PROVIDER_API_KEY 等环境变量后重试。", mapped.detail, { cause: mapped.cause });
+    }
+    return new WebSearchClientError(mapped.code, mapped.userMessage, mapped.detail, {
+        cause: mapped.cause,
+    });
+}
+/**
+ * 客户端整体超时（`TIMEOUT_WEB_SEARCH`）。
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.3
+ */
+export function getSearchTimeoutError(timeoutMs) {
+    return new WebSearchClientError("TIMEOUT_WEB_SEARCH", "搜索超时。请缩短查询词或减少 fetchTopN 后重试。", { timeoutMs });
+}
+/** 将 {@link WebFetchClientError} 转为本工具统一抛出的错误类型。 */
+export function asWebSearchClientError(err) {
+    return new WebSearchClientError(err.code, err.userMessage, err.detail, { cause: err.cause });
+}
+//# sourceMappingURL=errors.js.map

package/dist/tools/web-search/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/tools/web-search/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GAGvB,MAAM,qBAAqB,CAAC;AAG7B;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAI3B;IACA;IACA;IALT,IAAI,GAAG,sBAAsB,CAAC;IAEvC,YACkB,IAA6B,EAC7B,WAAmB,EACnB,MAAgB,EAChC,OAA6B;QAE7B,KAAK,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QALZ,SAAI,GAAJ,IAAI,CAAyB;QAC7B,gBAAW,GAAX,WAAW,CAAQ;QACnB,WAAM,GAAN,MAAM,CAAU;IAIlC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAC1C,UAAkB,EAClB,IAA8B,EAC9B,GAAyB;IAEzB,MAAM,MAAM,GAAG,sBAAsB,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IAC7D,IAAI,MAAM,CAAC,IAAI,KAAK,yBAAyB,EAAE,CAAC;QAC9C,OAAO,IAAI,oBAAoB,CAC7B,yBAAyB,EACzB,6EAA6E,EAC7E,MAAM,CAAC,MAAM,EACb,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CACxB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE;QAC9E,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB;IACrD,OAAO,IAAI,oBAAoB,CAC7B,oBAAoB,EACpB,+BAA+B,EAC/B,EAAE,SAAS,EAAE,CACd,CAAC;AACJ,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,sBAAsB,CAAC,GAAwB;IAC7D,OAAO,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;AAC/F,CAAC"}

package/dist/tools/web-search/executor.d.ts

@@ -0,0 +1,10 @@
+import type { ToolExecutionContext } from "../shared";
+import type { WebSearchToolInput, WebSearchToolOutput } from "./types";
+/**
+ * 调用 Web Fetch Server `POST /v1/search`。
+ *
+ * @see docs/adr/decisions/0003a-web-fetch-api-contract.md §Endpoint 3
+ * @see docs/adr/decisions/0003d-web-fetch-errors.md §2.2
+ */
+export declare function executeWebSearch(input: WebSearchToolInput, ctx: ToolExecutionContext): Promise<WebSearchToolOutput>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/web-search/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/tools/web-search/executor.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAQtD,OAAO,KAAK,EAAiC,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA+GtG;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,mBAAmB,CAAC,CA6C9B"}