@xyit/wellspring 0.0.0-stage → 1.1.0

package/dist/network/openai.js

@@ -0,0 +1,443 @@
+/*
+ * OpenAI SDK 接入。
+ * Responses API 为默认文本接口；chat 兼容只提供 Chat Completions 的网关。
+ * API key 读取顺序：显式参数 > OPENAI_API_KEY > <configDir>/credentials.json，
+ * 明文只进请求，不进配置、日志与界面。
+ */
+import OpenAI, { APIConnectionError, APIConnectionTimeoutError, APIError, APIUserAbortError, AuthenticationError, BadRequestError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, } from "openai";
+import { parseProviderUsage } from "../agent/usage.js";
+import { Result } from "../api/result/result.js";
+import { normalizeApiKey, resolveApiKeySync } from "../config/credentials.js";
+import { DEFAULT_SETTINGS } from "../config/defaults.js";
+import { readEnv } from "../platform/os.js";
+/** OpenAI 调用错误码 */
+export const OPENAI_CODES = {
+    missingApiKey: "openai.missing-api-key",
+    clientInitFailed: "openai.client-init-failed",
+    emptyOutput: "openai.empty-output",
+    timeout: "openai.timeout",
+    connectionFailed: "openai.connection-failed",
+    aborted: "openai.aborted",
+    unauthorized: "openai.unauthorized",
+    forbidden: "openai.forbidden",
+    notFound: "openai.not-found",
+    rateLimited: "openai.rate-limited",
+    badRequest: "openai.bad-request",
+    serverError: "openai.server-error",
+    apiError: "openai.api-error",
+    requestFailed: "openai.request-failed",
+};
+/** 把供应商 usage 里的缓存/推理项展开成可选字段，空值不写进回复对象 */
+function providerUsageFields(usage) {
+    if (usage === null) {
+        return {};
+    }
+    return {
+        ...(usage.cacheReadTokens === null ? {} : { cacheReadTokens: usage.cacheReadTokens }),
+        ...(usage.cacheWriteTokens === null ? {} : { cacheWriteTokens: usage.cacheWriteTokens }),
+        ...(usage.reasoningTokens === null ? {} : { reasoningTokens: usage.reasoningTokens }),
+    };
+}
+/**
+ * 推理强度映射：
+ * off 不发参数；low / high / max 原样发给 OpenAI 兼容端点。
+ * （标准 OpenAI 只定义到 high；若端点不接受 max 会返回 400，可换 high。）
+ */
+function reasoningParams(level) {
+    if (level === undefined || level === "" || level === "off") {
+        return {};
+    }
+    return { reasoning_effort: level };
+}
+/** 把 SDK 异常归一化为错误码 */
+export function mapOpenAIError(error) {
+    if (error instanceof APIUserAbortError) {
+        return OPENAI_CODES.aborted;
+    }
+    // APIConnectionTimeoutError 是 APIConnectionError 的子类，先判断超时
+    if (error instanceof APIConnectionTimeoutError) {
+        return OPENAI_CODES.timeout;
+    }
+    if (error instanceof APIConnectionError) {
+        return OPENAI_CODES.connectionFailed;
+    }
+    if (error instanceof AuthenticationError) {
+        return OPENAI_CODES.unauthorized;
+    }
+    if (error instanceof PermissionDeniedError) {
+        return OPENAI_CODES.forbidden;
+    }
+    if (error instanceof NotFoundError) {
+        return OPENAI_CODES.notFound;
+    }
+    if (error instanceof RateLimitError) {
+        return OPENAI_CODES.rateLimited;
+    }
+    if (error instanceof BadRequestError) {
+        return OPENAI_CODES.badRequest;
+    }
+    if (error instanceof InternalServerError) {
+        return OPENAI_CODES.serverError;
+    }
+    if (error instanceof APIError) {
+        return `${OPENAI_CODES.apiError}:${error.status ?? "unknown"}`;
+    }
+    return OPENAI_CODES.requestFailed;
+}
+export class OpenAIClient {
+    #client;
+    #settings;
+    #logger;
+    constructor(client, settings, logger) {
+        this.#client = client;
+        this.#settings = settings;
+        this.#logger = logger;
+    }
+    /** 创建客户端。缺少 API key 或 SDK 初始化失败时返回错误码 */
+    static create(options = {}) {
+        const settings = options.settings ?? DEFAULT_SETTINGS.openai;
+        const explicit = options.apiKey === undefined ? null : normalizeApiKey(options.apiKey);
+        if (options.apiKey !== undefined && explicit === null) {
+            return Result.error(OPENAI_CODES.missingApiKey);
+        }
+        const apiKey = explicit ??
+            (options.credentialsFile === undefined
+                ? resolveApiKeySync()
+                : resolveApiKeySync(options.credentialsFile))?.apiKey ??
+            null;
+        if (apiKey === null) {
+            return Result.error(OPENAI_CODES.missingApiKey);
+        }
+        try {
+            const client = new OpenAI({
+                apiKey,
+                timeout: settings.timeoutMs,
+                maxRetries: settings.maxRetries,
+                ...(settings.baseUrl === null ? {} : { baseURL: settings.baseUrl }),
+                ...(options.fetch === undefined ? {} : { fetch: options.fetch }),
+            });
+            return Result.successWithData(new OpenAIClient(client, settings, options.logger));
+        }
+        catch {
+            return Result.error(OPENAI_CODES.clientInitFailed);
+        }
+    }
+    /** 单轮文本生成，走 Responses API */
+    async respond(input, options = {}) {
+        const model = options.model ?? this.#settings.model;
+        try {
+            const response = await this.#client.responses.create({
+                model,
+                input,
+                ...(options.instructions === undefined
+                    ? {}
+                    : { instructions: options.instructions }),
+                ...(options.maxOutputTokens === undefined
+                    ? {}
+                    : { max_output_tokens: options.maxOutputTokens }),
+            });
+            const text = response.output_text;
+            if (text === "") {
+                return Result.error(OPENAI_CODES.emptyOutput);
+            }
+            this.#logger?.debug({ model: response.model, id: response.id }, "OpenAI Responses 调用");
+            const usage = parseProviderUsage(response.usage);
+            return Result.successWithData({
+                text,
+                model: response.model,
+                id: response.id,
+                inputTokens: usage?.inputTokens ?? null,
+                outputTokens: usage?.outputTokens ?? null,
+                ...providerUsageFields(usage),
+            });
+        }
+        catch (error) {
+            return this.failure(error, model);
+        }
+    }
+    /** 多轮对话，走 Chat Completions API */
+    async chat(messages, options = {}) {
+        const model = options.model ?? this.#settings.model;
+        try {
+            const completion = await this.#client.chat.completions.create({
+                model,
+                messages: [...messages],
+                ...(options.temperature === undefined ? {} : { temperature: options.temperature }),
+                ...(options.maxTokens === undefined
+                    ? {}
+                    : { max_completion_tokens: options.maxTokens }),
+                ...reasoningParams(options.reasoning),
+            });
+            const text = completion.choices[0]?.message.content ?? "";
+            if (text === "") {
+                return Result.error(OPENAI_CODES.emptyOutput);
+            }
+            this.#logger?.debug({ model: completion.model, id: completion.id }, "OpenAI Chat 调用");
+            const usage = parseProviderUsage(completion.usage);
+            return Result.successWithData({
+                text,
+                model: completion.model,
+                id: completion.id,
+                inputTokens: usage?.inputTokens ?? null,
+                outputTokens: usage?.outputTokens ?? null,
+                ...providerUsageFields(usage),
+            });
+        }
+        catch (error) {
+            return this.failure(error, model);
+        }
+    }
+    /** 流式 Chat Completions；始终请求流式，便于完整记录 chunk */
+    async chatStream(messages, options = {}) {
+        const model = options.model ?? this.#settings.model;
+        /* 累积状态放在 try 外：被 signal 中断时也要把已收到的部分交回去 */
+        const chunks = [];
+        let text = "";
+        let reasoning = "";
+        let id = "";
+        let responseModel = model;
+        let streamUsage = null;
+        let finishReason = null;
+        let blockStarted = false;
+        const toolCallMap = new Map();
+        const collectedToolCalls = () => [...toolCallMap.entries()]
+            .sort(([left], [right]) => left - right)
+            .map(([index, entry]) => ({
+            id: entry.id === "" ? `call_${index}` : entry.id,
+            name: entry.name,
+            arguments: entry.arguments,
+        }));
+        try {
+            const stream = await this.#client.chat.completions.create({
+                model,
+                messages: [...messages],
+                stream: true,
+                stream_options: { include_usage: true },
+                ...(options.temperature === undefined
+                    ? {}
+                    : { temperature: options.temperature }),
+                ...(options.maxTokens === undefined
+                    ? {}
+                    : { max_completion_tokens: options.maxTokens }),
+                ...reasoningParams(options.reasoning),
+                ...(options.tools === undefined || options.tools.length === 0
+                    ? {}
+                    : {
+                        tools: [...options.tools],
+                        tool_choice: options.toolChoice ?? "auto",
+                    }),
+            }, 
+            // signal 是请求选项（第二个参数），放进 body 只会被当成普通字段忽略
+            options.signal === undefined ? {} : { signal: options.signal });
+            const push = (chunk) => {
+                chunks.push({ type: "chunk", time: Date.now(), chunk });
+            };
+            for await (const part of stream) {
+                if (part.id !== "") {
+                    id = part.id;
+                }
+                if (part.model !== "") {
+                    responseModel = part.model;
+                }
+                if (part.usage !== undefined && part.usage !== null) {
+                    streamUsage = parseProviderUsage(part.usage);
+                    push({
+                        type: "usage",
+                        usage: {
+                            inputTokens: streamUsage?.inputTokens ?? null,
+                            outputTokens: streamUsage?.outputTokens ?? null,
+                            totalTokens: part.usage.total_tokens,
+                            ...(streamUsage?.cacheReadTokens === null ||
+                                streamUsage?.cacheReadTokens === undefined
+                                ? {}
+                                : { cacheReadTokens: streamUsage.cacheReadTokens }),
+                            ...(streamUsage?.cacheWriteTokens === null ||
+                                streamUsage?.cacheWriteTokens === undefined
+                                ? {}
+                                : { cacheWriteTokens: streamUsage.cacheWriteTokens }),
+                        },
+                    });
+                }
+                const choice = part.choices[0];
+                if (choice === undefined) {
+                    continue;
+                }
+                if (choice.finish_reason !== null && choice.finish_reason !== undefined) {
+                    finishReason = choice.finish_reason;
+                }
+                for (const toolCallDelta of choice.delta.tool_calls ?? []) {
+                    const index = toolCallDelta.index ?? toolCallMap.size;
+                    const entry = toolCallMap.get(index) ?? {
+                        id: "",
+                        name: "",
+                        arguments: "",
+                    };
+                    if (typeof toolCallDelta.id === "string") {
+                        entry.id = toolCallDelta.id;
+                    }
+                    if (typeof toolCallDelta.function?.name === "string") {
+                        entry.name += toolCallDelta.function.name;
+                    }
+                    if (typeof toolCallDelta.function?.arguments === "string") {
+                        entry.arguments += toolCallDelta.function.arguments;
+                    }
+                    toolCallMap.set(index, entry);
+                    push({
+                        type: "tool-call-delta",
+                        index,
+                        id: toolCallDelta.id ?? null,
+                        name: toolCallDelta.function?.name ?? null,
+                        argumentsDelta: toolCallDelta.function?.arguments ?? null,
+                    });
+                }
+                // 推理模型（DeepSeek 等）把思考内容放在 delta.reasoning_content，
+                // 部分网关用 delta.reasoning；两者都按增量拼接，不进正文
+                const rawDelta = choice.delta;
+                const reasoningDelta = typeof rawDelta.reasoning_content === "string"
+                    ? rawDelta.reasoning_content
+                    : typeof rawDelta.reasoning === "string"
+                        ? rawDelta.reasoning
+                        : "";
+                if (reasoningDelta !== "") {
+                    reasoning += reasoningDelta;
+                    push({ type: "reasoning-delta", index: 1, text: reasoningDelta });
+                    options.onReasoning?.(reasoningDelta);
+                }
+                const delta = rawDelta.content;
+                if (typeof delta === "string" && delta !== "") {
+                    if (!blockStarted) {
+                        push({ type: "block-start", index: 0, blockType: "text" });
+                        blockStarted = true;
+                    }
+                    text += delta;
+                    push({ type: "text-delta", index: 0, text: delta });
+                    options.onText?.(delta);
+                }
+            }
+            if (!blockStarted) {
+                push({ type: "block-start", index: 0, blockType: "text" });
+                push({ type: "block-end", index: 0, block: { type: "text", text } });
+            }
+            else {
+                push({ type: "block-end", index: 0, block: { type: "text", text } });
+            }
+            const toolCalls = collectedToolCalls();
+            for (const toolCall of toolCalls) {
+                push({ type: "tool-call", ...toolCall });
+            }
+            push({ type: "finish", reason: { kind: finishReason ?? "stop" } });
+            if (text === "" && toolCalls.length === 0) {
+                return Result.error(OPENAI_CODES.emptyOutput);
+            }
+            this.#logger?.debug({ model: responseModel, id }, "OpenAI Chat 流式调用");
+            return Result.successWithData({
+                reply: {
+                    text,
+                    model: responseModel,
+                    id,
+                    inputTokens: streamUsage?.inputTokens ?? null,
+                    outputTokens: streamUsage?.outputTokens ?? null,
+                    ...providerUsageFields(streamUsage),
+                },
+                chunks,
+                toolCalls,
+                reasoning,
+            });
+        }
+        catch (error) {
+            if (options.signal?.aborted === true) {
+                /*
+                 * 用户主动停止：不当作失败。把已经收到的正文/思考/工具调用照常交回去，
+                 * 由调用方按「已停止」收尾——半截回复比清空更有用。
+                 */
+                this.#logger?.debug({ model }, "OpenAI 流式调用被用户中断");
+                return Result.successWithData({
+                    interrupted: true,
+                    reply: {
+                        text,
+                        model: responseModel,
+                        id,
+                        inputTokens: streamUsage?.inputTokens ?? null,
+                        outputTokens: streamUsage?.outputTokens ?? null,
+                        ...providerUsageFields(streamUsage),
+                    },
+                    chunks,
+                    toolCalls: collectedToolCalls(),
+                    reasoning,
+                });
+            }
+            const code = mapOpenAIError(error);
+            const status = error instanceof APIError ? (error.status ?? null) : null;
+            const reason = error instanceof Error ? error.message : String(error);
+            this.#logger?.warn({ code, model, status, reason }, "OpenAI 流式调用失败");
+            return Result.error(code);
+        }
+    }
+    /** 拉取供应商的模型 id 列表（用于自定义供应商的“拉取模型”） */
+    async listModels() {
+        try {
+            const page = await this.#client.models.list();
+            const models = (page.data ?? [])
+                .map((item) => (typeof item?.id === "string" ? item.id.trim() : ""))
+                .filter((id) => id !== "");
+            if (models.length === 0) {
+                return Result.error(OPENAI_CODES.emptyOutput);
+            }
+            return Result.successWithData(models.sort());
+        }
+        catch (error) {
+            const code = mapOpenAIError(error);
+            const reason = error instanceof Error ? error.message : String(error);
+            this.#logger?.warn({ code, reason }, "拉取模型列表失败");
+            return Result.error(code);
+        }
+    }
+    /** 轻量连通性测试：拉模型列表，不产生对话费用 */
+    async testConnection() {
+        try {
+            const page = await this.#client.models.list();
+            const models = Array.isArray(page.data) ? page.data.length : 0;
+            if (models === 0) {
+                return Result.error(OPENAI_CODES.emptyOutput);
+            }
+            return Result.successWithData({ models });
+        }
+        catch (error) {
+            const code = mapOpenAIError(error);
+            const reason = error instanceof Error ? error.message : String(error);
+            this.#logger?.warn({ code, reason }, "OpenAI 连通性测试失败");
+            return Result.error(code);
+        }
+    }
+    failure(error, model) {
+        const code = mapOpenAIError(error);
+        const status = error instanceof APIError ? (error.status ?? null) : null;
+        const reason = error instanceof Error ? error.message : String(error);
+        this.#logger?.warn({ code, model, status, reason }, "OpenAI 调用失败");
+        return Result.error(code);
+    }
+}
+let current = null;
+/** 初始化全局客户端，已初始化时直接返回 */
+export function initOpenAIClient(options = {}) {
+    if (current !== null) {
+        return Result.successWithData(current);
+    }
+    const created = OpenAIClient.create(options);
+    if (created.isSuccess()) {
+        current = created.getData();
+    }
+    return created;
+}
+/** 取全局客户端，未初始化时抛错 */
+export function getOpenAIClient() {
+    if (current === null) {
+        throw new Error("OpenAI 客户端尚未初始化：先调用 initOpenAIClient()");
+    }
+    return current;
+}
+/** 清空全局客户端，供测试与关停使用 */
+export function resetOpenAIClient() {
+    current = null;
+}
+//# sourceMappingURL=openai.js.map

package/dist/network/openai.js.map

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

package/dist/network/proxy.d.ts

@@ -0,0 +1,9 @@
+import { fetch as undiciFetch } from "undici";
+import type { ProxySetting } from "../config/types.js";
+/** 判断 URL 是否命中 noProxy。支持 `*`、`example.com`、`.example.com`、子域后缀 */
+export declare function shouldBypassProxy(url: URL, noProxy: readonly string[]): boolean;
+/**
+ * 生成走代理的 fetch；proxy 为 null 时返回 undefined，调用方沿用全局 fetch。
+ * OpenAI SDK 接受自定义 fetch，这里是唯一注入点。
+ */
+export declare function createProxyFetch(proxy: ProxySetting | null): typeof undiciFetch | undefined;

package/dist/network/proxy.js

@@ -0,0 +1,72 @@
+/*
+ * HTTP/HTTPS 代理。
+ * 配置来自 app-setting.json 的 network.proxy；通过 undici 的 ProxyAgent 生成自定义 fetch。
+ * 只支持 HTTP/HTTPS 代理，SOCKS5 后续再加。
+ */
+import { ProxyAgent, fetch as undiciFetch } from "undici";
+/** 从 fetch 入参中取绝对 URL；取不到时返回 null */
+function toUrl(input) {
+    if (typeof input === "string") {
+        try {
+            return new URL(input);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (input instanceof URL) {
+        return input;
+    }
+    try {
+        return new URL(input.url);
+    }
+    catch {
+        return null;
+    }
+}
+function normalizePattern(pattern) {
+    return pattern
+        .trim()
+        .toLowerCase()
+        .replace(/^\*?\./, "");
+}
+/** 判断 URL 是否命中 noProxy。支持 `*`、`example.com`、`.example.com`、子域后缀 */
+export function shouldBypassProxy(url, noProxy) {
+    const host = url.hostname.toLowerCase();
+    for (const raw of noProxy) {
+        const pattern = normalizePattern(raw);
+        if (pattern === "") {
+            continue;
+        }
+        if (pattern === "*") {
+            return true;
+        }
+        if (host === pattern || host.endsWith(`.${pattern}`)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * 生成走代理的 fetch；proxy 为 null 时返回 undefined，调用方沿用全局 fetch。
+ * OpenAI SDK 接受自定义 fetch，这里是唯一注入点。
+ */
+export function createProxyFetch(proxy) {
+    if (proxy === null) {
+        return undefined;
+    }
+    const agent = new ProxyAgent({ uri: proxy.url });
+    const proxyFetch = (input, init) => {
+        const url = toUrl(input);
+        // 命中 noProxy 时用全局 fetch，避免代理自身不可达的主机被绕路
+        if (url !== null && shouldBypassProxy(url, proxy.noProxy)) {
+            return fetch(input, init);
+        }
+        return undiciFetch(input, {
+            ...init,
+            dispatcher: agent,
+        });
+    };
+    return proxyFetch;
+}
+//# sourceMappingURL=proxy.js.map

package/dist/network/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../src/network/proxy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAA;AAIzD,qCAAqC;AACrC,SAAS,KAAK,CAAC,KAA6B;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAA;QACzB,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,IAAI,CAAA;QACf,CAAC;IACL,CAAC;IACD,IAAI,KAAK,YAAY,GAAG,EAAE,CAAC;QACvB,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,IAAI,CAAC;QACD,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAC7B,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAA;IACf,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACrC,OAAO,OAAO;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;AAC9B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,GAAQ,EAAE,OAA0B;IAClE,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAA;IACvC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAA;QACrC,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACjB,SAAQ;QACZ,CAAC;QACD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;YAClB,OAAO,IAAI,CAAA;QACf,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,CAAC;YACnD,OAAO,IAAI,CAAA;QACf,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAA;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAA0B;IACvD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,SAAS,CAAA;IACpB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;IAChD,MAAM,UAAU,GAAG,CAAC,KAA6B,EAAE,IAAkB,EAAqB,EAAE;QACxF,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QACxB,wCAAwC;QACxC,IAAI,GAAG,KAAK,IAAI,IAAI,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;YACxD,OAAO,KAAK,CAAC,KAAe,EAAE,IAAmB,CAAsB,CAAA;QAC3E,CAAC;QACD,OAAO,WAAW,CACd,KAAc,EACd;YACI,GAAI,IAAgC;YACpC,UAAU,EAAE,KAAK;SACX,CACQ,CAAA;IAC1B,CAAC,CAAA;IACD,OAAO,UAA2C,CAAA;AACtD,CAAC"}

package/dist/network/web.d.ts

@@ -0,0 +1,34 @@
+import { Result } from "../api/result/result.js";
+export declare const WEB_CODES: {
+    readonly missingApiKey: "web.missing-api-key";
+    readonly invalidUrl: "web.invalid-url";
+    readonly requestFailed: "web.request-failed";
+    readonly searchFailed: "web.search-failed";
+    readonly fetchFailed: "web.fetch-failed";
+    readonly unsupported: "web.unsupported-provider";
+};
+export interface WebSearchResult {
+    readonly title: string;
+    readonly url: string;
+    readonly snippet: string;
+    readonly summary: string;
+    readonly content: string;
+    readonly siteName: string | null;
+    readonly date: string | null;
+    readonly authority: number;
+}
+export interface WebFetchResult {
+    readonly title: string;
+    readonly content: string;
+}
+export interface WebClient {
+    search(query: string, count?: number): Promise<Result<readonly WebSearchResult[]>>;
+    fetch(url: string): Promise<Result<WebFetchResult>>;
+}
+export interface WebClientOptions {
+    readonly baseUrl?: string | null;
+    readonly apiKey?: string;
+    readonly fetch?: typeof fetch;
+    readonly timeoutMs?: number;
+}
+export declare function createDeepSeekWebClient(options?: WebClientOptions): WebClient;