@qjp88995/provider-client 0.1.1 → 0.3.0

package/dist/web-search/moonshotai.adapter.js

@@ -0,0 +1,151 @@
+import { clip, codeOf, joinUrl, parseJson, postJson } from './http.js';
+import { recencySince, utcDate, WebSearchUpstreamError, } from './types.js';
+/**
+ * Kimi 工具网关（<https://platform.kimi.com/docs/api/tools-search>）：搜索基础版 `/search`、
+ * 专业版 `/search_pro`、网页抓取 `/fetch`。与对话 API 同一把 Bearer key；`web-search` 端点的根是
+ * `https://api.moonshot.cn/v1/tools`（国际站 `api.moonshot.ai`，两站账号与 key 不通用，在中心是两家厂商）。
+ * 专业版与抓取的文档只列了国内站，国际站沿用同一组路径。
+ *
+ * **不是 Formula 的 `moonshot/web-search`**：那个回 `encrypted_output`，只有 Kimi 模型读得了。
+ */
+/** 文档：两档的 `limit` 都是 1–20。工具层允许到 50，超出的压到上限而不是让上游 400。 */
+const MAX_LIMIT = 20;
+/**
+ * 基础版没有时间 / 域名过滤字段，给了就报回 `ignored`——文档没说认 `site:` 之类的操作符，
+ * 拼进查询是在猜。专业版有 `sites` 与 `time_window`，两项都施加。`include_content` 不开：
+ * 会把每条结果的全文塞回来，体量没有上限。
+ */
+export class MoonshotaiWebSearchAdapter {
+    now;
+    kind = 'moonshotai';
+    constructor(now = () => new Date()) {
+        this.now = now;
+    }
+    traits(settings) {
+        return {
+            readsPages: true,
+            maxResults: MAX_LIMIT,
+            filters: settings.searchTier === 'pro' ? ['recency', 'domain'] : [],
+            linksOftenMissing: false,
+            // 抓取的正文里图片是占位符（`![imageN](url)`），模型得知道那不是它能看的图。
+            pageImagesArePlaceholders: true,
+        };
+    }
+    async search(conn, settings, input, signal) {
+        const pro = settings.searchTier === 'pro';
+        const label = pro ? 'kimi search_pro' : 'kimi search';
+        const body = {
+            text_query: input.query,
+            ...(input.count !== undefined
+                ? { limit: Math.min(input.count, MAX_LIMIT) }
+                : {}),
+            ...(pro && input.domain ? { sites: [input.domain] } : {}),
+            ...(pro && input.recency
+                ? {
+                    time_window: {
+                        start: recencySince(input.recency, this.now()),
+                        end: utcDate(this.now()),
+                    },
+                }
+                : {}),
+        };
+        const res = await postJson(label, joinUrl(conn.baseUrl, pro ? 'search_pro' : 'search'), conn, body, signal);
+        if (!res.ok)
+            throw upstreamError(label, res.status, res.text);
+        const data = parseJson(label, res.text);
+        const items = (data.search_results ?? []).map(r => ({
+            title: r.title ?? '',
+            link: r.url ?? '',
+            content: r.snippet || bestChunk(r.chunks) || '',
+            media: r.site_name || null,
+            publishDate: r.date || null,
+        }));
+        const ignored = pro
+            ? []
+            : [
+                ...(input.recency ? ['recency'] : []),
+                ...(input.domain ? ['domain'] : []),
+            ];
+        return {
+            engine: pro ? 'kimi-pro' : 'kimi',
+            items,
+            ...(ignored.length ? { ignored } : {}),
+        };
+    }
+    async readPage(conn, _settings, input, signal) {
+        const label = 'kimi fetch';
+        const res = await postJson(label, joinUrl(conn.baseUrl, 'fetch'), conn, { url: input.url }, signal);
+        if (!res.ok) {
+            const err = errorBodyOf(res.text);
+            // 「读到了但没有可提取的正文」不是故障（也不计费）：交给工具层说「正文为空」，
+            // 别让模型当成链接坏了去重试。
+            if (res.status === 404 && err.type === 'markdown_not_found') {
+                return { url: input.url, title: null, description: null, content: '' };
+            }
+            throw upstreamError(label, res.status, res.text);
+        }
+        const data = parseJson(label, res.text);
+        if (typeof data.markdown !== 'string') {
+            throw new WebSearchUpstreamError('kimi fetch 响应缺少 markdown');
+        }
+        return {
+            url: data.url || input.url,
+            title: data.title || null,
+            description: null,
+            content: data.markdown,
+        };
+    }
+}
+/** 专业版的摘要偶尔为空，退回得分最高的正文片段。 */
+function bestChunk(chunks) {
+    let best;
+    for (const c of chunks ?? []) {
+        if (!c.text)
+            continue;
+        if (!best || (c.score ?? 0) > (best.score ?? 0))
+            best = c;
+    }
+    return best?.text;
+}
+/**
+ * 错误体是 `{error: {message, type, code?}}`，判别靠 `type`（`rate_limited` /
+ * `upstream_failed` …）；401 / 403 没有错误体（抓取的 403 `security_risk` 有）。
+ */
+function upstreamError(label, status, text) {
+    const err = errorBodyOf(text);
+    const detail = err.message ?? clip(text);
+    const hint = (err.type ? TYPE_HINTS[err.type] : undefined) ?? STATUS_HINTS[status];
+    return new WebSearchUpstreamError(`${label} ${status}${hint ? `（${hint}）` : ''}${detail ? `: ${detail}` : ''}`, {
+        code: err.type ?? err.code,
+        // 文档：429（限流 / 限流服务不可用）、500、502、504 稍后重试；400 / 403 改请求才有用。
+        retryable: status >= 500 || status === 429,
+    });
+}
+function errorBodyOf(text) {
+    try {
+        const body = JSON.parse(text);
+        return {
+            type: codeOf(body.error?.type),
+            code: codeOf(body.error?.code),
+            message: typeof body.error?.message === 'string'
+                ? body.error.message
+                : undefined,
+        };
+    }
+    catch {
+        return { type: undefined, code: undefined, message: undefined };
+    }
+}
+/** 文档里有确定含义的状态码，带进错误文案让模型 / 运营不必去查。 */
+const STATUS_HINTS = {
+    401: 'API key 无效，或与所选站点不匹配',
+    403: '账户未激活或已停用',
+    429: '超过频率或并发上限',
+    504: '超时，搜索就换个更短的关键词，读网页就稍后再试',
+};
+/** 同一个状态码含义不止一种时按 `type` 区分（抓取的 403 不是账户问题）。 */
+const TYPE_HINTS = {
+    security_risk: '这个网址被 Kimi 的安全策略拦下，换一个网址，重试没用',
+    invalid_url: '网址不合法，只支持 http / https',
+};
+//# sourceMappingURL=moonshotai.adapter.js.map

package/dist/web-search/moonshotai.adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"moonshotai.adapter.js","sourceRoot":"","sources":["../../src/web-search/moonshotai.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACvE,OAAO,EACL,YAAY,EACZ,OAAO,EASP,sBAAsB,GACvB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,0DAA0D;AAC1D,MAAM,SAAS,GAAG,EAAE,CAAC;AAwBrB;;;;GAIG;AACH,MAAM,OAAO,0BAA0B;IAGR;IAFpB,IAAI,GAAG,YAAqB,CAAC;IAEtC,YAA6B,MAAkB,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;QAAlC,QAAG,GAAH,GAAG,CAA+B;IAAG,CAAC;IAEnE,MAAM,CAAC,QAAkB;QACvB,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,SAAS;YACrB,OAAO,EAAE,QAAQ,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;YACnE,iBAAiB,EAAE,KAAK;YACxB,gDAAgD;YAChD,yBAAyB,EAAE,IAAI;SAChC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CACV,IAAyB,EACzB,QAAkB,EAClB,KAAqB,EACrB,MAAmB;QAEnB,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,KAAK,KAAK,CAAC;QAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,aAAa,CAAC;QACtD,MAAM,IAAI,GAA4B;YACpC,UAAU,EAAE,KAAK,CAAC,KAAK;YACvB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS;gBAC3B,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE;gBAC7C,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO;gBACtB,CAAC,CAAC;oBACE,WAAW,EAAE;wBACX,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;wBAC9C,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;qBACzB;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,KAAK,EACL,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,EACpD,IAAI,EACJ,IAAI,EACJ,MAAM,CACP,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QAE9D,MAAM,IAAI,GAAG,SAAS,CAAiB,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClD,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,EAAE;YACpB,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE;YACjB,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE;YAC/C,KAAK,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;YAC1B,WAAW,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI;SAC5B,CAAC,CAAC,CAAC;QACJ,MAAM,OAAO,GAAsB,GAAG;YACpC,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,SAAS,CAAW,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAW,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/C,CAAC;QACN,OAAO;YACL,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM;YACjC,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAyB,EACzB,SAAmB,EACnB,KAAsB,EACtB,MAAmB;QAEnB,MAAM,KAAK,GAAG,YAAY,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,QAAQ,CACxB,KAAK,EACL,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAC9B,IAAI,EACJ,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,EAClB,MAAM,CACP,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClC,yCAAyC;YACzC,iBAAiB;YACjB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,oBAAoB,EAAE,CAAC;gBAC5D,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;YACzE,CAAC;YACD,MAAM,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,IAAI,GAAG,SAAS,CAAgB,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACvD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,sBAAsB,CAAC,0BAA0B,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO;YACL,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG;YAC1B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,IAAI,CAAC,QAAQ;SACvB,CAAC;IACJ,CAAC;CACF;AAED,8BAA8B;AAC9B,SAAS,SAAS,CAChB,MAAuD;IAEvD,IAAI,IAAmD,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,MAAM,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,CAAC,CAAC,CAAC,IAAI;YAAE,SAAS;QACtB,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;YAAE,IAAI,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,EAAE,IAAI,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,SAAS,aAAa,CACpB,KAAa,EACb,MAAc,EACd,IAAY;IAEZ,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,IAAI,GACR,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACxE,OAAO,IAAI,sBAAsB,CAC/B,GAAG,KAAK,IAAI,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAC5E;QACE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI;QAC1B,0DAA0D;QAC1D,SAAS,EAAE,MAAM,IAAI,GAAG,IAAI,MAAM,KAAK,GAAG;KAC3C,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAK/B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAE3B,CAAC;QACF,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;YAC9B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC;YAC9B,OAAO,EACL,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,KAAK,QAAQ;gBACrC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;gBACpB,CAAC,CAAC,SAAS;SAChB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAClE,CAAC;AACH,CAAC;AAED,uCAAuC;AACvC,MAAM,YAAY,GAAqC;IACrD,GAAG,EAAE,sBAAsB;IAC3B,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,yBAAyB;CAC/B,CAAC;AAEF,gDAAgD;AAChD,MAAM,UAAU,GAAqC;IACnD,aAAa,EAAE,+BAA+B;IAC9C,WAAW,EAAE,wBAAwB;CACtC,CAAC"}

package/dist/web-search/types.d.ts

@@ -0,0 +1,120 @@
+import type { VendorFetch } from '../vendors/index.js';
+/**
+ * 联网搜索 / 读网页的厂商适配（从 agent-base `web-search/adapters` 搬来）。适配器只管「这家的请求长什么样、
+ * 响应怎么翻、哪些失败值得重试」；给模型看的工具说明是 APP 的事，适配器只交出事实（`WebSearchTraits`）。
+ */
+/** 时效过滤取值（缺省 = 不限时间）。各适配器自己翻成上游的写法。 */
+export declare const WEB_SEARCH_RECENCIES: readonly ["oneDay", "oneWeek", "oneMonth", "oneYear"];
+export type WebSearchRecency = (typeof WEB_SEARCH_RECENCIES)[number];
+/** 「最近一段时间」的起始日期（UTC，YYYY-MM-DD）——上游只收日期的家（DeepSeek、Kimi 专业版）共用。 */
+export declare function recencySince(recency: WebSearchRecency, now: Date): string;
+/** UTC 日期 YYYY-MM-DD。 */
+export declare function utcDate(d: Date): string;
+export interface WebSearchInput {
+    query: string;
+    count?: number;
+    recency?: WebSearchRecency;
+    domain?: string;
+}
+export interface WebSearchItem {
+    title: string;
+    link: string;
+    /** 搜索引擎给的摘要，不是网页全文。 */
+    content: string;
+    /** 来源站点 / 媒体名（常为空）。 */
+    media: string | null;
+    publishDate: string | null;
+}
+/** 搜索的两项过滤。不是每家都支持（Kimi 基础版、MiniMax 都没有），不支持的由适配器报回 `ignored`。 */
+export declare const WEB_SEARCH_FILTERS: readonly ["recency", "domain"];
+export type WebSearchFilter = (typeof WEB_SEARCH_FILTERS)[number];
+export interface WebSearchOutcome {
+    /** 「用的是哪个引擎」（智谱是档位名，其余是服务名）。 */
+    engine: string;
+    items: WebSearchItem[];
+    /**
+     * 调用方给了、这家却没法施加的过滤（缺省 = 都施加了）。调用方据此说破，别让模型以为
+     * 结果已经按时间 / 域名筛过。
+     */
+    ignored?: readonly WebSearchFilter[];
+}
+export interface WebPageOutcome {
+    url: string;
+    title: string | null;
+    description: string | null;
+    /** markdown 正文。可能为空串（纯脚本渲染 / 反爬页面、Kimi 的「没有可提取的正文」），由调用方解释。 */
+    content: string;
+}
+/**
+ * 调一次上游要的东西：这家 `web-search` 端点的根地址与出站 fetch。中心模式下 fetch 是中心的透传 fetch、
+ * 不带 key（中心注入）；直连模式给 `apiKey`，适配器以 Bearer 发出。
+ */
+export interface WebSearchConnection {
+    baseUrl: string;
+    fetch: VendorFetch;
+    apiKey?: string;
+}
+/** 智谱的搜索档位（`search_engine`）。 */
+export declare const ZHIPU_SEARCH_ENGINES: readonly ["search_std", "search_pro", "search_pro_sogou", "search_pro_quark"];
+export type ZhipuSearchEngine = (typeof ZHIPU_SEARCH_ENGINES)[number];
+/** Kimi 搜索：基础版 `/search`、专业版 `/search_pro`。 */
+export declare const KIMI_SEARCH_TIERS: readonly ["basic", "pro"];
+export type KimiSearchTier = (typeof KIMI_SEARCH_TIERS)[number];
+/**
+ * 各家的设置（APP 存、调用时传；缺省值见各适配器）。**站点（国内 / 海外）不是设置**：两站账号与 key 不通用，
+ * 在中心是两家厂商，地址取自各自的 `web-search` 端点。
+ */
+export interface WebSearchSettingsByKind {
+    deepseek: Record<string, never>;
+    moonshotai: {
+        searchTier?: KimiSearchTier;
+    };
+    minimax: Record<string, never>;
+    zhipu: {
+        searchEngine?: ZhipuSearchEngine;
+    };
+}
+export type WebSearchKind = keyof WebSearchSettingsByKind;
+export declare const WEB_SEARCH_KINDS: readonly ["deepseek", "moonshotai", "minimax", "zhipu"];
+export type WebSearchSettings<K extends WebSearchKind = WebSearchKind> = WebSearchSettingsByKind[K];
+/**
+ * 这家（在这组设置下）的能力事实，给调用方写工具说明用。只依赖设置，不依赖「现在」——写进工具表的东西
+ * 相邻两轮必须一样。
+ */
+export interface WebSearchTraits {
+    /** 有读网页接口（MiniMax 没有）。 */
+    readsPages: boolean;
+    /** 一次最多返回几条；null = 没有比调用方更紧的上限。 */
+    maxResults: number | null;
+    /** 真能施加的过滤；不在里面的给了也会报回 `ignored`。 */
+    filters: readonly WebSearchFilter[];
+    /** 结果常不带链接（智谱 search_std，真机探针 2026-08-31）：「把链接交给读网页」常走不通。 */
+    linksOftenMissing: boolean;
+    /** 读网页的正文里图片只以 `![imageN](url)` 占位（Kimi），看不到图片内容。 */
+    pageImagesArePlaceholders: boolean;
+}
+export interface WebSearchAdapter<K extends WebSearchKind> {
+    readonly kind: K;
+    traits(settings: WebSearchSettings<K>): WebSearchTraits;
+    search(conn: WebSearchConnection, settings: WebSearchSettings<K>, input: WebSearchInput, signal: AbortSignal): Promise<WebSearchOutcome>;
+    /** 没有读网页接口的家（MiniMax）不实现，`traits().readsPages` 同步写 false（spec 钉着）。 */
+    readPage?(conn: WebSearchConnection, settings: WebSearchSettings<K>, input: {
+        url: string;
+    }, signal: AbortSignal): Promise<WebPageOutcome>;
+}
+/**
+ * 联网服务的上游失败（非 2xx / 网络错误 / 响应体不成形 / 2xx 里的业务错误）。中心自己报的错（没有可用 key、
+ * 接入方不许用这家……）不是这个，是 `ProviderClientError`。
+ */
+export declare class WebSearchUpstreamError extends Error {
+    readonly name = "WebSearchUpstreamError";
+    /** 上游业务错误码（智谱的 '1701' 并发超限、DeepSeek 的 error.code、Kimi 的 error.type），没有就是 null。 */
+    readonly code: string | null;
+    /** 这次失败值不值得重试。判据收在各适配器的抛出处，调用方只读这个标志，不解析消息文本。 */
+    readonly retryable: boolean;
+    constructor(reason: string, opts?: {
+        code?: string;
+        retryable?: boolean;
+    });
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/web-search/types.d.ts.map

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

package/dist/web-search/types.js

@@ -0,0 +1,60 @@
+/**
+ * 联网搜索 / 读网页的厂商适配（从 agent-base `web-search/adapters` 搬来）。适配器只管「这家的请求长什么样、
+ * 响应怎么翻、哪些失败值得重试」；给模型看的工具说明是 APP 的事，适配器只交出事实（`WebSearchTraits`）。
+ */
+/** 时效过滤取值（缺省 = 不限时间）。各适配器自己翻成上游的写法。 */
+export const WEB_SEARCH_RECENCIES = [
+    'oneDay',
+    'oneWeek',
+    'oneMonth',
+    'oneYear',
+];
+const DAY_MS = 24 * 60 * 60 * 1000;
+const RECENCY_DAYS = {
+    oneDay: 1,
+    oneWeek: 7,
+    oneMonth: 30,
+    oneYear: 365,
+};
+/** 「最近一段时间」的起始日期（UTC，YYYY-MM-DD）——上游只收日期的家（DeepSeek、Kimi 专业版）共用。 */
+export function recencySince(recency, now) {
+    return utcDate(new Date(now.getTime() - RECENCY_DAYS[recency] * DAY_MS));
+}
+/** UTC 日期 YYYY-MM-DD。 */
+export function utcDate(d) {
+    return d.toISOString().slice(0, 10);
+}
+/** 搜索的两项过滤。不是每家都支持（Kimi 基础版、MiniMax 都没有），不支持的由适配器报回 `ignored`。 */
+export const WEB_SEARCH_FILTERS = ['recency', 'domain'];
+/** 智谱的搜索档位（`search_engine`）。 */
+export const ZHIPU_SEARCH_ENGINES = [
+    'search_std',
+    'search_pro',
+    'search_pro_sogou',
+    'search_pro_quark',
+];
+/** Kimi 搜索：基础版 `/search`、专业版 `/search_pro`。 */
+export const KIMI_SEARCH_TIERS = ['basic', 'pro'];
+export const WEB_SEARCH_KINDS = [
+    'deepseek',
+    'moonshotai',
+    'minimax',
+    'zhipu',
+];
+/**
+ * 联网服务的上游失败（非 2xx / 网络错误 / 响应体不成形 / 2xx 里的业务错误）。中心自己报的错（没有可用 key、
+ * 接入方不许用这家……）不是这个，是 `ProviderClientError`。
+ */
+export class WebSearchUpstreamError extends Error {
+    name = 'WebSearchUpstreamError';
+    /** 上游业务错误码（智谱的 '1701' 并发超限、DeepSeek 的 error.code、Kimi 的 error.type），没有就是 null。 */
+    code;
+    /** 这次失败值不值得重试。判据收在各适配器的抛出处，调用方只读这个标志，不解析消息文本。 */
+    retryable;
+    constructor(reason, opts = {}) {
+        super(reason);
+        this.code = opts.code ?? null;
+        this.retryable = opts.retryable ?? false;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/web-search/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web-search/types.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,uCAAuC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,SAAS;IACT,UAAU;IACV,SAAS;CACD,CAAC;AAGX,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACnC,MAAM,YAAY,GAA+C;IAC/D,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,EAAE;IACZ,OAAO,EAAE,GAAG;CACb,CAAC;AAEF,oEAAoE;AACpE,MAAM,UAAU,YAAY,CAAC,OAAyB,EAAE,GAAS;IAC/D,OAAO,OAAO,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,OAAO,CAAC,CAAO;IAC7B,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAmBD,kEAAkE;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAgCjE,gCAAgC;AAChC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,YAAY;IACZ,YAAY;IACZ,kBAAkB;IAClB,kBAAkB;CACV,CAAC;AAGX,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,KAAK,CAAU,CAAC;AAc3D,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,UAAU;IACV,YAAY;IACZ,SAAS;IACT,OAAO;CACoC,CAAC;AAuC9C;;;GAGG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7B,IAAI,GAAG,wBAAwB,CAAC;IAClD,kFAAkF;IACzE,IAAI,CAAgB;IAC7B,iDAAiD;IACxC,SAAS,CAAU;IAE5B,YACE,MAAc,EACd,OAA+C,EAAE;QAEjD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;IAC3C,CAAC;CACF"}

package/dist/web-search/zhipu.adapter.d.ts

@@ -0,0 +1,14 @@
+import { type WebPageOutcome, type WebSearchAdapter, type WebSearchConnection, type WebSearchInput, type WebSearchOutcome, type WebSearchSettings, type WebSearchTraits } from './types.js';
+type Settings = WebSearchSettings<'zhipu'>;
+/** 智谱「工具 API」：联网搜索（web_search）+ 网页阅读（reader）。 */
+export declare class ZhipuWebSearchAdapter implements WebSearchAdapter<'zhipu'> {
+    readonly kind: "zhipu";
+    traits(settings: Settings): WebSearchTraits;
+    search(conn: WebSearchConnection, settings: Settings, input: WebSearchInput, signal: AbortSignal): Promise<WebSearchOutcome>;
+    readPage(conn: WebSearchConnection, _settings: Settings, input: {
+        url: string;
+    }, signal: AbortSignal): Promise<WebPageOutcome>;
+    private post;
+}
+export {};
+//# sourceMappingURL=zhipu.adapter.d.ts.map

package/dist/web-search/zhipu.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zhipu.adapter.d.ts","sourceRoot":"","sources":["../../src/web-search/zhipu.adapter.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EAGrB,MAAM,YAAY,CAAC;AAgCpB,KAAK,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAE3C,iDAAiD;AACjD,qBAAa,qBAAsB,YAAW,gBAAgB,CAAC,OAAO,CAAC;IACrE,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAEjC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe;IAYrC,MAAM,CACV,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,gBAAgB,CAAC;IAkCtB,QAAQ,CACZ,IAAI,EAAE,mBAAmB,EACzB,SAAS,EAAE,QAAQ,EACnB,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,EACtB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,cAAc,CAAC;YA6BZ,IAAI;CA0CnB"}

package/dist/web-search/zhipu.adapter.js

@@ -0,0 +1,98 @@
+import { clip, codeOf, joinUrl, parseErrorBody, parseJson, postJson, } from './http.js';
+import { WebSearchUpstreamError, } from './types.js';
+/**
+ * 智谱工具 API 的根取自这家的 `web-search` 端点（`https://open.bigmodel.cn/api/paas/v4`），下挂 `/web_search`、`/reader`。
+ * 不从对话端点推：chat 根是 `/api/paas/v4`、responses 根是 `/api/v1`，从哪条推都是猜。
+ */
+/** 不设档位时用高阶版（agent-base 的缺省）。 */
+const DEFAULT_ENGINE = 'search_pro';
+/** reader 让智谱侧抓取页面的预算（秒）——上游参数，不是本地超时。 */
+const READER_FETCH_TIMEOUT_SECONDS = 20;
+/** 智谱「工具 API」：联网搜索（web_search）+ 网页阅读（reader）。 */
+export class ZhipuWebSearchAdapter {
+    kind = 'zhipu';
+    traits(settings) {
+        return {
+            readsPages: true,
+            maxResults: null,
+            filters: ['recency', 'domain'],
+            // 真机探针（2026-08-31）：search_std 常返回空 link，「把链接交给读网页」就走不通。
+            linksOftenMissing: (settings.searchEngine ?? DEFAULT_ENGINE) === 'search_std',
+            pageImagesArePlaceholders: false,
+        };
+    }
+    async search(conn, settings, input, signal) {
+        const engine = settings.searchEngine ?? DEFAULT_ENGINE;
+        const body = {
+            search_query: input.query,
+            search_engine: engine,
+            // 意图识别用不上：调用方（模型）自己就是意图层，开了只多花一份钱。
+            search_intent: false,
+            ...(input.count !== undefined ? { count: input.count } : {}),
+            ...(input.recency ? { search_recency_filter: input.recency } : {}),
+            ...(input.domain ? { search_domain_filter: input.domain } : {}),
+        };
+        let data;
+        try {
+            data = await this.post('web_search', conn, body, signal);
+        }
+        catch (err) {
+            // 1703 = 搜索引擎没返回有效数据。这是「零结果」不是「上游坏了」——报成
+            // 错误会让模型把一次正常的空搜索当成故障去重试，而它该做的是换关键词。
+            if (err instanceof WebSearchUpstreamError && err.code === '1703') {
+                return { engine, items: [] };
+            }
+            throw err;
+        }
+        const items = (data.search_result ?? []).map(r => ({
+            title: r.title ?? '',
+            link: r.link ?? '',
+            content: r.content ?? '',
+            media: r.media || null,
+            publishDate: r.publish_date || null,
+        }));
+        return { engine, items };
+    }
+    async readPage(conn, _settings, input, signal) {
+        const data = await this.post('reader', conn, {
+            url: input.url,
+            return_format: 'markdown',
+            // 剥掉图片：远程图片链接模型看不了（ViewImage 只读工作空间），留着
+            // 只是往上下文里灌一堆没用的长 URL。
+            retain_images: false,
+            timeout: READER_FETCH_TIMEOUT_SECONDS,
+        }, signal);
+        const r = data.reader_result;
+        if (!r || typeof r.content !== 'string') {
+            throw new WebSearchUpstreamError('zhipu reader 响应缺少 reader_result.content');
+        }
+        return {
+            url: r.url || input.url,
+            title: r.title || null,
+            description: r.description || null,
+            content: r.content,
+        };
+    }
+    async post(path, conn, body, signal) {
+        const label = `zhipu ${path}`;
+        const res = await postJson(label, joinUrl(conn.baseUrl, path), conn, body, signal);
+        if (!res.ok) {
+            const parsed = parseErrorBody(res.text);
+            const detail = parsed.message ?? clip(res.text);
+            throw new WebSearchUpstreamError(`${label} ${res.status}${detail ? `: ${detail}` : ''}`, {
+                code: parsed.code,
+                retryable: res.status >= 500 || res.status === 429 || parsed.code === '1701',
+            });
+        }
+        const json = parseJson(label, res.text);
+        // 智谱部分接口会用 200 + error 体报业务错误，别把它当成功往下传。
+        const errBody = json
+            .error;
+        if (errBody) {
+            const code = codeOf(errBody.code);
+            throw new WebSearchUpstreamError(`${label} 业务错误${code ? ` ${code}` : ''}：${typeof errBody.message === 'string' ? errBody.message : clip(res.text)}`, { code, retryable: code === '1701' });
+        }
+        return json;
+    }
+}
+//# sourceMappingURL=zhipu.adapter.js.map

package/dist/web-search/zhipu.adapter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qjp88995/provider-client",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Client for the provider center: vendor adapters for the AI SDK, model resolution through the center's catalog and passthrough proxy, and a direct mode for local development.",
   "license": "UNLICENSED",
   "type": "module",
@@ -33,7 +33,9 @@
     "@ai-sdk/google": "^4.0.104",
     "@ai-sdk/moonshotai": "^3.0.76",
     "@ai-sdk/openai": "^4.0.101",
-    "@ai-sdk/openai-compatible": "^3.0.77"
+    "@ai-sdk/openai-compatible": "^3.0.77",
+    "fflate": "^0.8.3",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "ai": "^7.0.150"
@@ -43,7 +45,6 @@
     "ai": "^7.0.150",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "zod": "^4.4.3",
     "@pc/shared": "0.1.0"
   },
   "scripts": {

package/src/direct-resolver.ts

@@ -48,6 +48,8 @@ export class DirectModelResolver implements ModelResolver {
       slug: v.slug,
       name: v.name ?? v.slug,
       kind: v.kind,
+      // 直连只给 LLM 厂商用（非 LLM 厂商在 APP 里本来就直接拿 key 调）。
+      category: 'llm',
       apiKey: v.apiKey,
       fetch: v.fetch,
       endpoints: v.endpoints,

package/src/index.ts

@@ -9,6 +9,75 @@ export {
   ProviderClientError,
   type ProviderClientErrorCode,
 } from './errors.js';
+export {
+  classifyCode,
+  createJustOne,
+  type JustOne,
+  JUSTONE_BASE_URL,
+  JUSTONE_ENDPOINTS,
+  JUSTONE_FAILURE_KINDS,
+  JUSTONE_PRICE_FEN,
+  JUSTONE_PRICING_EXPORTED_AT,
+  JUSTONE_TIMEOUT_MS,
+  type JustOneAttemptRecord,
+  type JustOneCallOptions,
+  type JustOneConnection,
+  type JustOneEndpointKey,
+  type JustOneEndpointSpec,
+  justOneEndpointSpec,
+  type JustOneFailureKind,
+  type JustOneOptions,
+  type JustOneParams,
+  JustOneParamsError,
+  type JustOneParamsOf,
+  type JustOneParamSpec,
+  justOnePriceFen,
+  type JustOneResult,
+  JustOneUpstreamError,
+  type JustOneUpstreamFailureKind,
+  type NormalizedParams,
+  normalizeParams,
+} from './justone/index.js';
+export {
+  type AudioOutcome,
+  type AudioRequest,
+  BibiGptApiError,
+  BibiGptNetworkError,
+  buildPolishPrompt,
+  type CacheKeyOpts,
+  createMedia,
+  type CreateMediaInput,
+  directMediaConnection,
+  type FileOutcome,
+  type FileRequest,
+  isMediaKind,
+  localizeSummaryHeadings,
+  MEDIA_ADAPTERS,
+  MEDIA_CAPABILITIES,
+  MEDIA_KINDS,
+  type MediaAdapter,
+  type MediaCapability,
+  type MediaConnection,
+  type MediaInput,
+  type MediaKind,
+  type MediaService,
+  type MediaSettings,
+  type MediaSettingsByKind,
+  MediaUpstreamError,
+  pageFromExpertName,
+  type ParsedImage,
+  parseParserPackage,
+  type TokenUsage,
+  type UploadLimitHint,
+  type VideoLinkChapter,
+  type VideoLinkOutcome,
+  type VideoLinkRequest,
+  type VideoLinkSubtitle,
+  ZHIPU_AUDIO_MAX_BYTES,
+  ZHIPU_FILE_TOOL_TYPES,
+  ZHIPU_MIME_TO_EXT,
+  type ZhipuFileToolType,
+} from './media/index.js';
 export {
   type ModelFileStore,
   type ModelHandle,
@@ -18,8 +87,12 @@ export {
   type UploadedFile,
 } from './model-handle.js';
 export {
+  type FetchForOptions,
+  type JustOneClientOptions,
+  type MediaOptions,
   ProviderClient,
   type ProviderClientOptions,
+  type WebSearchOptions,
 } from './provider-client.js';
 export { toProviderClientError } from './to-error.js';
 export {
@@ -29,6 +102,8 @@ export {
   type CatalogVendor,
   CENTER_ERROR_CODES,
   type CenterErrorCode,
+  ENDPOINT_PROTOCOLS,
+  type EndpointProtocol,
   LLM_CAPABILITIES,
   LLM_PROTOCOLS,
   type LlmCapability,
@@ -38,7 +113,9 @@ export {
   PROXY_ROUTE_PREFIX,
   REASONING_EFFORTS,
   type ReasoningEffort,
+  VENDOR_CATEGORIES,
   VENDOR_KINDS,
+  type VendorCategory,
   type VendorKind,
 } from './types.js';
 export {
@@ -52,3 +129,30 @@ export {
   VENDOR_ADAPTERS,
   type VendorFetch,
 } from './vendors/index.js';
+export {
+  createWebSearch,
+  type CreateWebSearchInput,
+  isWebSearchKind,
+  KIMI_SEARCH_TIERS,
+  type KimiSearchTier,
+  WEB_SEARCH_ADAPTERS,
+  WEB_SEARCH_FILTERS,
+  WEB_SEARCH_KINDS,
+  WEB_SEARCH_RECENCIES,
+  type WebPageOutcome,
+  type WebSearch,
+  type WebSearchAdapter,
+  type WebSearchConnection,
+  type WebSearchFilter,
+  type WebSearchInput,
+  type WebSearchItem,
+  type WebSearchKind,
+  type WebSearchOutcome,
+  type WebSearchRecency,
+  type WebSearchSettings,
+  type WebSearchSettingsByKind,
+  type WebSearchTraits,
+  WebSearchUpstreamError,
+  ZHIPU_SEARCH_ENGINES,
+  type ZhipuSearchEngine,
+} from './web-search/index.js';