@dsh-cove/dsh-web-all 0.4.3 → 0.4.4

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   node scripts/verify-docs.mjs --write <dir>
-README.md: 6f249597efea1432892e1131f28237318e0b9d6c
-README.zh.md: e211acee1437b94a4337027350edea4932aa242c
+README.md: 2f89063b064015de6cf116470803300f2914ded7
+README.zh.md: 8c2fa8a3f08546befad8d5a1cc6967f020af1c59

package/README.md

@@ -25,8 +25,12 @@ The web profile runtime stack is `@deepseek-ai/dsh-base` + `@deepseek-ai/dsh-web
 
 ```sh
 dsh plugin --profile web add @dsh-cove/dsh-web-all@latest
+# Stopped on ERR_PNPM_IGNORED_BUILDS? Add the printed keys to the profile's
+# pnpm-workspace.yaml allowBuilds, then remove and add again: that failed run
+# already wrote the dependency, and a plain re-run writes only the dependency,
+# never the profile bundle row.
+dsh --profile web --dump-config  # a mounted web-all row is the proof it registered
 # Restart the managed dsh web process after installation.
-dsh --profile web --dump-config
 ```
 
 For DSH Desktop, replace `web` with `desktop`, verify with `dsh --profile desktop --dump-config`, then fully quit and reopen the desktop application.

package/README.zh.md

@@ -25,8 +25,11 @@ Web profile 的运行时栈是 `@deepseek-ai/dsh-base` + `@deepseek-ai/dsh-web-a
 
 ```sh
 dsh plugin --profile web add @dsh-cove/dsh-web-all@latest
+# 卡在 ERR_PNPM_IGNORED_BUILDS？把提示的键加进 profile 的 pnpm-workspace.yaml
+# allowBuilds，然后先 remove 再 add：失败的那次已写入依赖，直接重跑只会写依赖，
+# 不会登记 profile 的 bundle 行。
+dsh --profile web --dump-config  # 挂载出 web-all 行才算登记成功
 # 安装后重启受管的 dsh web 进程。
-dsh --profile web --dump-config
 ```
 
 DSH Desktop 请把 `web` 替换为 `desktop`，用 `dsh --profile desktop --dump-config` 验证，然后完全退出并重新打开桌面应用。

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dsh-cove/dsh-web-all",
   "description": "DSH Web GUI 全家桶插件（实体版）：按 dsh 注入位置组织的单一插件——侧栏（sidebar）/ 设置（settings）/ 会话区（conversation）/ 浮层（flyout）四个位置模块统一编排，host 半区按服务域承载各能力。安装一个插件即全家桶全部能力。",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "type": "module",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"

package/lib/types/core/subagent-model/model-resolver.d.ts

@@ -1,25 +0,0 @@
-/**
- * Dependency-free model and reasoning-effort resolution for subagent history.
- * The browser position module feeds this resolver rows returned by the existing
- * read-only subagents/history RPC; malformed history is ignored defensively.
- */
-/** Minimal transcript row shape accepted by the resolver. */
-export interface SubagentModelHistoryEntry {
-    readonly event?: unknown;
-}
-/** Model identity actually used by one subagent run. */
-export interface SubagentRunInfo {
-    readonly model: string;
-    readonly reasoningEffort?: string;
-}
-/**
- * Resolve the first request header model, including its reasoning effort when
- * present. A descriptor agentModel is retained only as a fallback because the
- * request header is the per-request ground truth.
- */
-export declare function resolveSubagentRun(entries: readonly SubagentModelHistoryEntry[]): SubagentRunInfo | undefined;
-/** Resolve only the model identifier for callers that do not need effort. */
-export declare function resolveSubagentModel(entries: readonly SubagentModelHistoryEntry[]): string | undefined;
-/** Format the visible badge as `model` or `model · effort`. */
-export declare function formatSubagentBadgeText(info: SubagentRunInfo): string;
-//# sourceMappingURL=model-resolver.d.ts.map

package/lib/types/core/subagent-model/model-resolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"model-resolver.d.ts","sourceRoot":"","sources":["../../../../src/core/subagent-model/model-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6DAA6D;AAC7D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,SAAS,yBAAyB,EAAE,GAC5C,eAAe,GAAG,SAAS,CAU7B;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,yBAAyB,EAAE,GAC5C,MAAM,GAAG,SAAS,CAEpB;AAED,+DAA+D;AAC/D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAIrE"}

package/lib/types/core/subagent-model/model-resolver.js

@@ -1,60 +0,0 @@
-/**
- * Dependency-free model and reasoning-effort resolution for subagent history.
- * The browser position module feeds this resolver rows returned by the existing
- * read-only subagents/history RPC; malformed history is ignored defensively.
- */
-/**
- * Resolve the first request header model, including its reasoning effort when
- * present. A descriptor agentModel is retained only as a fallback because the
- * request header is the per-request ground truth.
- */
-export function resolveSubagentRun(entries) {
-    let descriptorModel;
-    for (const entry of entries) {
-        const requestRun = readRequestHeaderRun(entry?.event);
-        if (requestRun !== undefined)
-            return requestRun;
-        if (descriptorModel === undefined) {
-            descriptorModel = readDescriptorModel(entry?.event);
-        }
-    }
-    return descriptorModel === undefined ? undefined : { model: descriptorModel };
-}
-/** Resolve only the model identifier for callers that do not need effort. */
-export function resolveSubagentModel(entries) {
-    return resolveSubagentRun(entries)?.model;
-}
-/** Format the visible badge as `model` or `model · effort`. */
-export function formatSubagentBadgeText(info) {
-    return info.reasoningEffort === undefined
-        ? info.model
-        : `${info.model} · ${info.reasoningEffort}`;
-}
-function readRequestHeaderRun(event) {
-    if (!isRecord(event) || event.type !== 'request/header')
-        return undefined;
-    const data = event.data;
-    if (!isRecord(data) || !isRecord(data.header) || !isRecord(data.header.config)) {
-        return undefined;
-    }
-    const model = nonBlankString(data.header.config.model);
-    if (model === undefined)
-        return undefined;
-    const reasoningEffort = nonBlankString(data.header.config.reasoningEffort);
-    return reasoningEffort === undefined ? { model } : { model, reasoningEffort };
-}
-function readDescriptorModel(event) {
-    if (!isRecord(event) || event.type !== 'subagent/descriptor' || !isRecord(event.data)) {
-        return undefined;
-    }
-    return nonBlankString(event.data.agentModel);
-}
-function isRecord(value) {
-    return typeof value === 'object' && value !== null;
-}
-function nonBlankString(value) {
-    if (typeof value !== 'string')
-        return undefined;
-    const trimmed = value.trim();
-    return trimmed.length === 0 ? undefined : trimmed;
-}

package/lib/types/host/services/web-search-kaon/contracts.d.ts

@@ -1,114 +0,0 @@
-/**
- * Anthropic 兼容 Messages 检索后端的契约、设置 schema 与默认值 —— host 半区。
- *
- * 原生 `dsh-web-search-deepseek` 同样走「Anthropic 兼容 Messages + 原生
- * `web_search_20250305` 服务端工具」，但它把响应里**必须出现
- * `web_search_tool_result` 块**当成硬前提（缺席即抛 `WEB_PROVIDER_ERROR`）。
- * Kaon Router 上的 Claude 系模型（上游 Bedrock）只回 `server_tool_use` 与带
- * `citations[]` 的 `text` 块：命中的 URL、标题与摘录全部藏在 citation 里，
- * 结果块根本不存在。因此把 deepseek provider 的 `baseURL` 直接指过去，
- * 搜索**确实执行了**却必然报「no web_search_tool_result blocks」。
- *
- * 本域因此注册第二个 search provider（id `kaon-router`），把两种响应形状都
- * 归一化成 seam 的 `sources[]`：
- *
- *   1. 标准 Anthropic 形状：`web_search_tool_result` 条目 + `text.citations[]` 摘录；
- *   2. Kaon/Bedrock 形状：没有结果块，只有 `citations[]`（`web_search_result_location`）。
- *
- * 端点、模型、凭据引用都可在 `web-search-kaon` 命名空间里改，所以任何
- * Anthropic 兼容 Messages 端点都能用，Kaon 只是默认值。
- *
- * @module web-all/host/services/web-search-kaon
- */
-import z from 'schemastery';
-/** 设置命名空间：`web-search-kaon`。 */
-export declare const WEB_SEARCH_KAON_SETTINGS_NAMESPACE = "web-search-kaon";
-/** 注册到 `ctx.web` 的 search provider id；profile 用它 pin `searchProvider`。 */
-export declare const WEB_SEARCH_KAON_PROVIDER_ID = "kaon-router";
-/** 默认端点，含 `/v1`；`/messages` 由 provider 追加。 */
-export declare const WEB_SEARCH_KAON_DEFAULT_BASE_URL = "https://kaon-router.kaonai.com/v1";
-/**
- * 默认模型。必须是**端点侧真正执行服务端搜索**的 Anthropic 模型：Kaon 上的
- * `kaon/deepseek-*`、`kaon/gemini-*` 会把 `web_search` 当普通客户端工具回一个
- * `tool_use`（模型自己申请调用，没有任何搜索结果），provider 会照实报错。
- */
-export declare const WEB_SEARCH_KAON_DEFAULT_MODEL = "kaon/claude-haiku-4-5-20251001";
-/** 默认 `anthropic-version` 头。 */
-export declare const WEB_SEARCH_KAON_DEFAULT_API_VERSION = "2023-06-01";
-/** 单次 Messages 请求的生成上限（模型侧摘要用）。 */
-export declare const WEB_SEARCH_KAON_DEFAULT_MAX_TOKENS = 4096;
-/** 单次搜索允许的服务端 `web_search` 调用次数上限。 */
-export declare const WEB_SEARCH_KAON_DEFAULT_MAX_USES = 3;
-/** 默认凭据引用；与 chat 侧 `llm-pi-ai` 的 kaon-router 路由共用同一把 key。 */
-export declare const WEB_SEARCH_KAON_DEFAULT_API_KEY_ENV = "KAON_ROUTER_API_KEY";
-/** 用户可配置面（也是设置文档里该命名空间的字段）。 */
-export interface WebSearchKaonConfig {
-    /** Anthropic 兼容端点基址，不含 `/messages`。 */
-    baseURL?: string;
-    /** Anthropic 格式模型名。 */
-    model?: string;
-    /** 凭据引用名（凭据服务 / 环境变量）；优于环境变量，劣于字面 apiKey。 */
-    apiKeyEnv?: string;
-    /** 字面 key；仅当没有凭据服务时使用，优先于 apiKeyEnv。 */
-    apiKey?: string;
-    /** `anthropic-version` 头。 */
-    apiVersion?: string;
-    /** 生成上限。 */
-    maxTokens?: number;
-    /** 服务端搜索次数上限。 */
-    maxUses?: number;
-    /** 是否把模型生成的摘要并入 seam 的 `content`。 */
-    includeAnswer?: boolean;
-    /** 单次请求硬上限（毫秒）。 */
-    timeoutMs?: number;
-}
-/** 运行时的权威 schema；导出后该命名空间才会出现在设置文档里。 */
-export declare const Config: z<WebSearchKaonConfig>;
-/** 解析后的配置：字段全部落地，无 undefined。 */
-export type ResolvedWebSearchKaonConfig = Required<WebSearchKaonConfig>;
-/** 提取一份可用配置：未配置的字段取 schema 默认值。 */
-export declare function effectiveConfig(config: WebSearchKaonConfig | undefined): ResolvedWebSearchKaonConfig;
-/** 一次搜索请求；seam 传 query 与可选上限。 */
-export interface WebSearchRequest {
-    readonly query: string;
-    readonly maxResults?: number;
-}
-/** 一条可引用来源。 */
-export interface WebSearchSource {
-    readonly url: string;
-    readonly title?: string;
-    readonly snippet?: string;
-    readonly publishedAt?: string;
-}
-/** 归一化后的搜索产出。 */
-export interface WebSearchResult {
-    readonly content?: string;
-    readonly sources: readonly WebSearchSource[];
-    readonly truncated: boolean;
-}
-/** 一个搜索后端。 */
-export interface WebSearchProvider {
-    readonly id: string;
-    /** 廉价的本地可用性检查；不得发起网络请求。 */
-    available(): boolean;
-    search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
-}
-/** `ctx.web` 上本域用到的部分。 */
-export interface WebSeam {
-    registerSearchProvider(provider: WebSearchProvider): () => void;
-}
-/** `ctx.credentials` 上本域用到的部分（可选服务）。 */
-export interface CredentialSeam {
-    resolve(ref: string): Promise<{
-        value: string;
-    } | undefined>;
-}
-/**
- * 检索失败。形状对齐 `WebError`（带机器可路由的 `code`），
- * 由 `dsh-tool-web` 包装成模型可读的 `Error: <message>`。
- */
-export declare class WebSearchError extends Error {
-    readonly code: string;
-    constructor(message: string, code: string);
-}
-//# sourceMappingURL=contracts.d.ts.map

package/lib/types/host/services/web-search-kaon/contracts.d.ts.map

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

package/lib/types/host/services/web-search-kaon/contracts.js

@@ -1,73 +0,0 @@
-/**
- * Anthropic 兼容 Messages 检索后端的契约、设置 schema 与默认值 —— host 半区。
- *
- * 原生 `dsh-web-search-deepseek` 同样走「Anthropic 兼容 Messages + 原生
- * `web_search_20250305` 服务端工具」，但它把响应里**必须出现
- * `web_search_tool_result` 块**当成硬前提（缺席即抛 `WEB_PROVIDER_ERROR`）。
- * Kaon Router 上的 Claude 系模型（上游 Bedrock）只回 `server_tool_use` 与带
- * `citations[]` 的 `text` 块：命中的 URL、标题与摘录全部藏在 citation 里，
- * 结果块根本不存在。因此把 deepseek provider 的 `baseURL` 直接指过去，
- * 搜索**确实执行了**却必然报「no web_search_tool_result blocks」。
- *
- * 本域因此注册第二个 search provider（id `kaon-router`），把两种响应形状都
- * 归一化成 seam 的 `sources[]`：
- *
- *   1. 标准 Anthropic 形状：`web_search_tool_result` 条目 + `text.citations[]` 摘录；
- *   2. Kaon/Bedrock 形状：没有结果块，只有 `citations[]`（`web_search_result_location`）。
- *
- * 端点、模型、凭据引用都可在 `web-search-kaon` 命名空间里改，所以任何
- * Anthropic 兼容 Messages 端点都能用，Kaon 只是默认值。
- *
- * @module web-all/host/services/web-search-kaon
- */
-import z from 'schemastery';
-import { registerFamilyNamespace } from "../family-config.js";
-/** 设置命名空间：`web-search-kaon`。 */
-export const WEB_SEARCH_KAON_SETTINGS_NAMESPACE = 'web-search-kaon';
-/** 注册到 `ctx.web` 的 search provider id；profile 用它 pin `searchProvider`。 */
-export const WEB_SEARCH_KAON_PROVIDER_ID = 'kaon-router';
-/** 默认端点，含 `/v1`；`/messages` 由 provider 追加。 */
-export const WEB_SEARCH_KAON_DEFAULT_BASE_URL = 'https://kaon-router.kaonai.com/v1';
-/**
- * 默认模型。必须是**端点侧真正执行服务端搜索**的 Anthropic 模型：Kaon 上的
- * `kaon/deepseek-*`、`kaon/gemini-*` 会把 `web_search` 当普通客户端工具回一个
- * `tool_use`（模型自己申请调用，没有任何搜索结果），provider 会照实报错。
- */
-export const WEB_SEARCH_KAON_DEFAULT_MODEL = 'kaon/claude-haiku-4-5-20251001';
-/** 默认 `anthropic-version` 头。 */
-export const WEB_SEARCH_KAON_DEFAULT_API_VERSION = '2023-06-01';
-/** 单次 Messages 请求的生成上限（模型侧摘要用）。 */
-export const WEB_SEARCH_KAON_DEFAULT_MAX_TOKENS = 4_096;
-/** 单次搜索允许的服务端 `web_search` 调用次数上限。 */
-export const WEB_SEARCH_KAON_DEFAULT_MAX_USES = 3;
-/** 默认凭据引用；与 chat 侧 `llm-pi-ai` 的 kaon-router 路由共用同一把 key。 */
-export const WEB_SEARCH_KAON_DEFAULT_API_KEY_ENV = 'KAON_ROUTER_API_KEY';
-/** 运行时的权威 schema；导出后该命名空间才会出现在设置文档里。 */
-export const Config = z.object({
-    baseURL: z.string().default(WEB_SEARCH_KAON_DEFAULT_BASE_URL),
-    model: z.string().default(WEB_SEARCH_KAON_DEFAULT_MODEL),
-    apiKeyEnv: z.string().default(WEB_SEARCH_KAON_DEFAULT_API_KEY_ENV),
-    apiKey: z.string().role('secret').default(''),
-    apiVersion: z.string().default(WEB_SEARCH_KAON_DEFAULT_API_VERSION),
-    maxTokens: z.number().step(1).min(1).default(WEB_SEARCH_KAON_DEFAULT_MAX_TOKENS),
-    maxUses: z.number().step(1).min(1).default(WEB_SEARCH_KAON_DEFAULT_MAX_USES),
-    includeAnswer: z.boolean().default(true),
-    timeoutMs: z.number().step(1).min(1).default(120_000),
-});
-registerFamilyNamespace(WEB_SEARCH_KAON_SETTINGS_NAMESPACE, Config);
-/** 提取一份可用配置：未配置的字段取 schema 默认值。 */
-export function effectiveConfig(config) {
-    return Config(config ?? {});
-}
-/**
- * 检索失败。形状对齐 `WebError`（带机器可路由的 `code`），
- * 由 `dsh-tool-web` 包装成模型可读的 `Error: <message>`。
- */
-export class WebSearchError extends Error {
-    code;
-    constructor(message, code) {
-        super(message);
-        this.name = 'WebError';
-        this.code = code;
-    }
-}

package/lib/types/host/services/web-search-kaon/index.d.ts

@@ -1,50 +0,0 @@
-/**
- * Kaon Router 检索服务域 —— 向 `ctx.web` 注册 `kaon-router` search provider。
- *
- * ## 为什么注册是「只要 web 在就注册」
- *
- * profile patch 把 `@deepseek-ai/dsh-web` 的 `searchProvider` pin 成 `kaon-router`。
- * seam 在指定了 id 时只用该 id：provider 缺席报
- * `WEB_PROVIDER_CONFIGURED_MISSING`，注册了但 `available()` 为假报
- * `WEB_PROVIDER_CONFIGURED_UNAVAILABLE`——两者都会让 `web_search` 整体不可用。
- * 因此这里选择「只要 web 服务在就注册」：key 缺失属于运行期错误，由 provider
- * 按次给出 `WEB_PROVIDER_CREDENTIAL_MISSING`，并点名该配的凭据引用。
- *
- * 要彻底关掉本域，必须**同时**把 `searchProvider` 改回 `deepseek-official`
- * （见 cordis.patch.yml 的注释），只删这一段会留下一个指向不存在 provider 的 pin。
- *
- * ## 为什么用局部 inject
- *
- * 0.2 严格注入下，插件只能访问自己 inject 声明过的服务。这里用
- * `ctx.inject(['web'], …)` / `ctx.inject(['credentials'], …)` 等待，而不是把
- * 它们写进 web-all 的全局 inject：那会让整个全家桶在缺少这些服务的 profile 里挂掉。
- *
- * ## 配置读取
- *
- * `web-search-kaon` 是聚合 Config 里的一个 volatile 命名空间；provider 拿到的是
- * **读取函数**而非快照，端点/模型/次数上限的热更新立即生效，无需重挂插件。
- *
- * @module web-all/host/services/web-search-kaon
- */
-import type { Context } from '@deepseek-ai/cordis';
-import { type WebSearchKaonConfig } from './contracts.ts';
-export interface WebSearchKaonRegistrationOptions {
-    /** 结构化告警出口；缺省写 console。 */
-    logger?: {
-        warn: (message: string) => void;
-    };
-    /** 显式配置（测试用）。缺省时从 `web-search-kaon` 命名空间读取。 */
-    config?: WebSearchKaonConfig;
-    /** 环境变量读取面（测试用）。缺省读 `process.env`。 */
-    env?: (name: string) => string | undefined;
-}
-/**
- * 注册 Anthropic 兼容检索 provider。
- * @param ctx - host plugin context。
- * @param options - 告警出口与显式配置（测试）。
- * @returns 卸载回调：注销 provider。
- */
-export declare function register(ctx: Context, options?: WebSearchKaonRegistrationOptions): () => void;
-export { effectiveConfig, WEB_SEARCH_KAON_DEFAULT_API_KEY_ENV, WEB_SEARCH_KAON_DEFAULT_BASE_URL, WEB_SEARCH_KAON_DEFAULT_MODEL, WEB_SEARCH_KAON_PROVIDER_ID, WEB_SEARCH_KAON_SETTINGS_NAMESPACE, type WebSearchKaonConfig, } from './contracts.ts';
-export { citationSnippets, KaonSearchProvider, mapSearchResponse } from './provider.ts';
-//# sourceMappingURL=index.d.ts.map

package/lib/types/host/services/web-search-kaon/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/web-search-kaon/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAKL,KAAK,mBAAmB,EAEzB,MAAM,gBAAgB,CAAA;AAGvB,MAAM,WAAW,gCAAgC;IAC/C,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;IAC5C,+CAA+C;IAC/C,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B,sCAAsC;IACtC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CAC3C;AAWD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,gCAAqC,GAAG,MAAM,IAAI,CAmEjG;AAED,OAAO,EACL,eAAe,EACf,mCAAmC,EACnC,gCAAgC,EAChC,6BAA6B,EAC7B,2BAA2B,EAC3B,kCAAkC,EAClC,KAAK,mBAAmB,GACzB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA"}

package/lib/types/host/services/web-search-kaon/index.js

@@ -1,114 +0,0 @@
-/**
- * Kaon Router 检索服务域 —— 向 `ctx.web` 注册 `kaon-router` search provider。
- *
- * ## 为什么注册是「只要 web 在就注册」
- *
- * profile patch 把 `@deepseek-ai/dsh-web` 的 `searchProvider` pin 成 `kaon-router`。
- * seam 在指定了 id 时只用该 id：provider 缺席报
- * `WEB_PROVIDER_CONFIGURED_MISSING`，注册了但 `available()` 为假报
- * `WEB_PROVIDER_CONFIGURED_UNAVAILABLE`——两者都会让 `web_search` 整体不可用。
- * 因此这里选择「只要 web 服务在就注册」：key 缺失属于运行期错误，由 provider
- * 按次给出 `WEB_PROVIDER_CREDENTIAL_MISSING`，并点名该配的凭据引用。
- *
- * 要彻底关掉本域，必须**同时**把 `searchProvider` 改回 `deepseek-official`
- * （见 cordis.patch.yml 的注释），只删这一段会留下一个指向不存在 provider 的 pin。
- *
- * ## 为什么用局部 inject
- *
- * 0.2 严格注入下，插件只能访问自己 inject 声明过的服务。这里用
- * `ctx.inject(['web'], …)` / `ctx.inject(['credentials'], …)` 等待，而不是把
- * 它们写进 web-all 的全局 inject：那会让整个全家桶在缺少这些服务的 profile 里挂掉。
- *
- * ## 配置读取
- *
- * `web-search-kaon` 是聚合 Config 里的一个 volatile 命名空间；provider 拿到的是
- * **读取函数**而非快照，端点/模型/次数上限的热更新立即生效，无需重挂插件。
- *
- * @module web-all/host/services/web-search-kaon
- */
-import { familyNamespace } from "../family-config.js";
-import { effectiveConfig, WEB_SEARCH_KAON_PROVIDER_ID, WEB_SEARCH_KAON_SETTINGS_NAMESPACE, } from "./contracts.js";
-import { KaonSearchProvider } from "./provider.js";
-/** 可选读取 credentials 缝隙：0.2 严格注入下访问未声明的服务会直接抛错。 */
-function credentialSeamOf(ctx) {
-    try {
-        return ctx.credentials;
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * 注册 Anthropic 兼容检索 provider。
- * @param ctx - host plugin context。
- * @param options - 告警出口与显式配置（测试）。
- * @returns 卸载回调：注销 provider。
- */
-export function register(ctx, options = {}) {
-    const warn = options.logger?.warn ?? ((message) => console.warn(message));
-    const readConfig = () => effectiveConfig(options.config ?? familyNamespace(WEB_SEARCH_KAON_SETTINGS_NAMESPACE));
-    const env = options.env ?? ((name) => process.env[name]);
-    // 凭据服务是可选依赖：没有它时 provider 仍注册，key 回落到环境变量或字面 apiKey。
-    let credentials;
-    try {
-        ctx.inject(['credentials'], (cctx) => { credentials = credentialSeamOf(cctx); });
-    }
-    catch {
-        // 该 profile 没有 credentials 服务：静默缺席，不影响注册。
-    }
-    const provider = new KaonSearchProvider(() => {
-        const config = readConfig();
-        return {
-            baseURL: config.baseURL,
-            model: config.model,
-            apiVersion: config.apiVersion,
-            maxTokens: config.maxTokens,
-            maxUses: config.maxUses,
-            includeAnswer: config.includeAnswer,
-            timeoutMs: config.timeoutMs,
-            apiKeyEnv: config.apiKeyEnv,
-            ...config.apiKey !== '' ? { apiKey: config.apiKey } : {},
-            resolveApiKey: async () => {
-                try {
-                    const stored = await credentials?.resolve(config.apiKeyEnv);
-                    if (stored !== undefined && stored.value.length > 0)
-                        return stored.value;
-                }
-                catch {
-                    // 凭据服务拒绝解析（引用不存在/语法非法）时退回环境变量。
-                }
-                const ambient = env(config.apiKeyEnv);
-                return ambient !== undefined && ambient.length > 0 ? ambient : undefined;
-            },
-        };
-    });
-    const initial = readConfig();
-    if (!URL.canParse(initial.baseURL)) {
-        warn(`[web-all:web-search-kaon] baseURL 不是合法 URL（${JSON.stringify(initial.baseURL)}）：`
-            + `web_search 仍被 pin 到 ${WEB_SEARCH_KAON_PROVIDER_ID}，调用会以 WEB_PROVIDER_CONFIGURED_UNAVAILABLE 失败；`
-            + `请在 ${WEB_SEARCH_KAON_SETTINGS_NAMESPACE} 命名空间里改回 Anthropic 兼容端点`);
-    }
-    let disposed = false;
-    let unregister;
-    try {
-        ctx.inject(['web'], (cctx) => {
-            if (disposed)
-                return;
-            const seam = cctx.web;
-            if (seam?.registerSearchProvider === undefined)
-                return;
-            unregister = seam.registerSearchProvider(provider);
-        });
-    }
-    catch (error) {
-        // 组合里没有 web 服务：本域静默缺席，绝不影响全家桶其余能力。
-        warn(`[web-all:web-search-kaon] 等待 web 服务失败，本域缺席：${error instanceof Error ? error.message : String(error)}`);
-        return () => undefined;
-    }
-    return () => {
-        disposed = true;
-        unregister?.();
-    };
-}
-export { effectiveConfig, WEB_SEARCH_KAON_DEFAULT_API_KEY_ENV, WEB_SEARCH_KAON_DEFAULT_BASE_URL, WEB_SEARCH_KAON_DEFAULT_MODEL, WEB_SEARCH_KAON_PROVIDER_ID, WEB_SEARCH_KAON_SETTINGS_NAMESPACE, } from "./contracts.js";
-export { citationSnippets, KaonSearchProvider, mapSearchResponse } from "./provider.js";

package/lib/types/host/services/web-search-kaon/provider.d.ts

@@ -1,111 +0,0 @@
-/**
- * Kaon Router（Anthropic 兼容 Messages）搜索 provider。
- *
- * 一次搜索 = 一次 Messages 请求 + 原生 `web_search_20250305` 服务端工具：代价是
- * 一个模型回合，回报是结构化结果块。与原生 deepseek provider 的唯一实质差别是
- * **响应归一化**：本 provider 同时接受标准 Anthropic 形状（`web_search_tool_result`
- * 条目 + citation 摘录）和 Kaon/Bedrock 形状（没有结果块，只有 citation），
- * 并且在「模型只是申请调用客户端工具」时给出可操作的报错，而不是假装搜到了东西。
- *
- * 配置按**每次搜索**从注入的读取器取，因此 `web-search-kaon` 命名空间的热更新
- * （端点/模型/次数上限）立即生效，无需重挂插件。
- *
- * `available()` 只做本地判断（key 解析器存在、URL 可解析、上限为正整数），
- * 不发网络请求（seam 的硬要求）。
- *
- * @module web-all/host/services/web-search-kaon
- */
-import { type WebSearchProvider, type WebSearchRequest, type WebSearchResult, type WebSearchSource } from './contracts.ts';
-/** 一次引用位置（Kaon 把命中信息全放在这里）。 */
-export interface CitationLocation {
-    type?: string;
-    url?: string | null;
-    title?: string | null;
-    cited_text?: string | null;
-}
-/** 一个内容块；只消费下方注释里列出的几种。 */
-export interface ContentBlock {
-    type?: string;
-    text?: string | null;
-    name?: string | null;
-    citations?: readonly CitationLocation[] | null;
-    /** `web_search_tool_result` 的载荷：条目数组，或一个错误对象。 */
-    content?: unknown;
-}
-/** `web_search_tool_result` 里的一个可引用条目。 */
-export interface SearchResultItem {
-    type?: string;
-    url?: string | null;
-    title?: string | null;
-    page_age?: string | null;
-}
-/** Anthropic Messages 响应信封（best-effort；字段随上游而变）。 */
-export interface AnthropicResponse {
-    content?: readonly ContentBlock[] | null;
-    stop_reason?: string | null;
-    usage?: {
-        server_tool_use?: {
-            web_search_requests?: number | null;
-        } | null;
-    } | null;
-}
-/** 归一化结果：来源、可选的模型摘要，以及用于诊断的检索事实。 */
-export interface MappedSearchResponse {
-    sources: readonly WebSearchSource[];
-    /** 模型生成的摘要文本（取最长的一段非空 text 块）。 */
-    content?: string;
-    /** 端点侧实际执行的服务端搜索次数（0 表示没搜）。 */
-    searches: number;
-    /** 响应里有 `tool_use(web_search)`：模型申请调用客户端工具，端点没执行搜索。 */
-    clientToolUse: boolean;
-    /** `web_search_tool_result` 自带的错误码（有则整体失败）。 */
-    resultError?: string;
-}
-/** 一次搜索的运行期选项快照。 */
-export interface KaonSearchProviderOptions {
-    /** 端点基址，不含 `/messages`。 */
-    baseURL: string;
-    model: string;
-    apiVersion: string;
-    maxTokens: number;
-    maxUses: number;
-    /** 是否把模型摘要并入 `content`。 */
-    includeAnswer: boolean;
-    timeoutMs: number;
-    /** 字面 key；存在时优先于 {@link resolveApiKey}。 */
-    apiKey?: string;
-    /** 每次搜索解析一次当前 key（凭据服务 / 环境变量）。 */
-    resolveApiKey?: () => Promise<string | undefined>;
-    /** 凭据引用名，只用于报错文案。 */
-    apiKeyEnv?: string;
-    /** 注入的 fetch，测试用。 */
-    fetchImpl?: typeof fetch;
-}
-/** 收集每个 URL 的 citation 摘录（首次出现优先）；标准形状下它才是 snippet 来源。 */
-export declare function citationSnippets(blocks: readonly ContentBlock[]): Map<string, string>;
-/**
- * 把两种 Anthropic 兼容响应形状统一成 seam 的 `sources[]`。
- *
- * 顺序：先走标准结果块（带 `page_age` 与条目级字段），拿不到任何条目时再回落到
- * citation —— Kaon 的 Claude 路由永远走第二条分支；两条分支都用同一张 citation
- * 摘录表补 `snippet`，按 URL 去重（`max_uses > 1` 时同一 URL 可能多次出现）。
- *
- * @param response - 解析后的 Messages 响应体。
- * @returns 归一化结果；`searches`/`clientToolUse`/`resultError` 供诊断使用。
- */
-export declare function mapSearchResponse(response: AnthropicResponse): MappedSearchResponse;
-/** 用 Anthropic 兼容 Messages 端点做检索的 provider。 */
-export declare class KaonSearchProvider implements WebSearchProvider {
-    readonly id = "kaon-router";
-    private readonly resolveOptions;
-    /**
-     * @param resolveOptions - 下一次操作的选项；thunk 而非快照，命名空间热更新因此
-     * 每次搜索都生效，而不必重注册 provider（重注册会让 seam 的选择对用户可见地抖动）。
-     */
-    constructor(resolveOptions: () => KaonSearchProviderOptions);
-    available(): boolean;
-    search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
-    /** 解析一次操作的 key：字面 key → 凭据服务 → 环境变量。 */
-    private apiKey;
-}
-//# sourceMappingURL=provider.d.ts.map

package/lib/types/host/services/web-search-kaon/provider.d.ts.map

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

package/lib/types/host/services/web-search-kaon/provider.js

@@ -1,244 +0,0 @@
-/**
- * Kaon Router（Anthropic 兼容 Messages）搜索 provider。
- *
- * 一次搜索 = 一次 Messages 请求 + 原生 `web_search_20250305` 服务端工具：代价是
- * 一个模型回合，回报是结构化结果块。与原生 deepseek provider 的唯一实质差别是
- * **响应归一化**：本 provider 同时接受标准 Anthropic 形状（`web_search_tool_result`
- * 条目 + citation 摘录）和 Kaon/Bedrock 形状（没有结果块，只有 citation），
- * 并且在「模型只是申请调用客户端工具」时给出可操作的报错，而不是假装搜到了东西。
- *
- * 配置按**每次搜索**从注入的读取器取，因此 `web-search-kaon` 命名空间的热更新
- * （端点/模型/次数上限）立即生效，无需重挂插件。
- *
- * `available()` 只做本地判断（key 解析器存在、URL 可解析、上限为正整数），
- * 不发网络请求（seam 的硬要求）。
- *
- * @module web-all/host/services/web-search-kaon
- */
-import { WebSearchError, WEB_SEARCH_KAON_PROVIDER_ID, } from "./contracts.js";
-/** 归因头；与 provider 行为一起演进。 */
-const USER_AGENT = 'dsh-web-all/web-search-kaon';
-/** 收集每个 URL 的 citation 摘录（首次出现优先）；标准形状下它才是 snippet 来源。 */
-export function citationSnippets(blocks) {
-    const map = new Map();
-    for (const block of blocks) {
-        if (block.type !== 'text')
-            continue;
-        for (const cite of block.citations ?? []) {
-            const url = cite.url ?? '';
-            const text = cite.cited_text ?? '';
-            if (url !== '' && text !== '' && !map.has(url))
-                map.set(url, text);
-        }
-    }
-    return map;
-}
-/** 读出 `web_search_tool_result` 自带的错误（载荷是对象而非数组时）。 */
-function resultErrorOf(block) {
-    const payload = block.content;
-    if (payload === null || typeof payload !== 'object' || Array.isArray(payload))
-        return undefined;
-    const record = payload;
-    if (record.error_code === undefined || record.error_code === null)
-        return undefined;
-    return `${String(record.type ?? 'web_search_tool_result_error')}: ${String(record.error_code)}`;
-}
-/**
- * 把两种 Anthropic 兼容响应形状统一成 seam 的 `sources[]`。
- *
- * 顺序：先走标准结果块（带 `page_age` 与条目级字段），拿不到任何条目时再回落到
- * citation —— Kaon 的 Claude 路由永远走第二条分支；两条分支都用同一张 citation
- * 摘录表补 `snippet`，按 URL 去重（`max_uses > 1` 时同一 URL 可能多次出现）。
- *
- * @param response - 解析后的 Messages 响应体。
- * @returns 归一化结果；`searches`/`clientToolUse`/`resultError` 供诊断使用。
- */
-export function mapSearchResponse(response) {
-    const blocks = response.content ?? [];
-    const searches = response.usage?.server_tool_use?.web_search_requests
-        ?? blocks.filter(block => block.type === 'server_tool_use' && block.name === 'web_search').length;
-    const clientToolUse = blocks.some(block => block.type === 'tool_use' && block.name === 'web_search');
-    const resultError = blocks.filter(block => block.type === 'web_search_tool_result')
-        .map(resultErrorOf)
-        .find(error => error !== undefined);
-    const snippets = citationSnippets(blocks);
-    const sources = [];
-    const seen = new Set();
-    const add = (url, title, snippet, publishedAt) => {
-        const value = url ?? '';
-        if (value === '' || seen.has(value))
-            return;
-        seen.add(value);
-        sources.push({
-            url: value,
-            ...title !== null && title !== undefined && title !== '' ? { title } : {},
-            ...snippet !== null && snippet !== undefined && snippet !== '' ? { snippet } : {},
-            ...publishedAt !== null && publishedAt !== undefined && publishedAt !== '' ? { publishedAt } : {},
-        });
-    };
-    for (const block of blocks) {
-        if (block.type !== 'web_search_tool_result' || !Array.isArray(block.content))
-            continue;
-        for (const item of block.content) {
-            if (item?.type !== 'web_search_result')
-                continue;
-            const url = item.url ?? '';
-            add(url, item.title, snippets.get(url), item.page_age);
-        }
-    }
-    if (sources.length === 0) {
-        for (const block of blocks) {
-            if (block.type !== 'text')
-                continue;
-            for (const cite of block.citations ?? [])
-                add(cite.url, cite.title, cite.cited_text);
-        }
-    }
-    let content;
-    for (const block of blocks) {
-        if (block.type !== 'text')
-            continue;
-        const text = block.text ?? '';
-        if (text.length > (content?.length ?? 0))
-            content = text;
-    }
-    return {
-        sources,
-        ...content !== undefined ? { content } : {},
-        searches,
-        clientToolUse,
-        ...resultError !== undefined ? { resultError } : {},
-    };
-}
-/** 去掉尾斜杠，避免 `baseURL` 以 `/` 结尾时拼出 `//messages`。 */
-function trimTrailingSlash(value) {
-    return value.endsWith('/') ? value.replace(/\/+$/u, '') : value;
-}
-/** 端点与配置引导：把「这是配置问题、改哪里」写进错误里。 */
-function endpointHint(endpoint) {
-    return `\n\nThe web search request used endpoint ${JSON.stringify(endpoint)}. Search endpoint configuration is separate from chat: guide the user to the web-search-kaon settings namespace (Settings > Plugins > Plugin configuration, the web-all entry) or to web-search-kaon.baseURL in the profile cordis.patch.yml. Only the user should change the endpoint.`;
-}
-/** 端点没执行搜索时的可操作报错：区分「模型申请客户端工具」与「搜了但没结果」。 */
-function noResultError(mapped, options) {
-    if (mapped.clientToolUse) {
-        return new WebSearchError(`The endpoint returned a client-side tool_use(web_search) instead of executing the search itself, so model ${JSON.stringify(options.model)} `
-            + 'has no web search results. Native server-side web_search_20250305 is an Anthropic-model feature: on Kaon Router pick a kaon/claude-* model '
-            + '(kaon/deepseek-* and kaon/gemini-* reply with a client tool call). The provider was left pointed at this endpoint on purpose; only the user should change it.', 'WEB_PROVIDER_ERROR');
-    }
-    if (mapped.searches === 0) {
-        return new WebSearchError(`The endpoint executed no server-side web search for model ${JSON.stringify(options.model)} and returned no citeable sources; `
-            + 'the request may not have triggered native web search.', 'WEB_PROVIDER_ERROR');
-    }
-    return new WebSearchError(`The endpoint executed ${mapped.searches} server-side web search(es) but returned no citeable sources.`, 'WEB_PROVIDER_ERROR');
-}
-/** 用 Anthropic 兼容 Messages 端点做检索的 provider。 */
-export class KaonSearchProvider {
-    id = WEB_SEARCH_KAON_PROVIDER_ID;
-    resolveOptions;
-    /**
-     * @param resolveOptions - 下一次操作的选项；thunk 而非快照，命名空间热更新因此
-     * 每次搜索都生效，而不必重注册 provider（重注册会让 seam 的选择对用户可见地抖动）。
-     */
-    constructor(resolveOptions) {
-        this.resolveOptions = resolveOptions;
-    }
-    available() {
-        const options = this.resolveOptions();
-        return ((options.apiKey?.length ?? 0) > 0 || options.resolveApiKey !== undefined)
-            && URL.canParse(options.baseURL)
-            && Number.isInteger(options.maxTokens) && options.maxTokens > 0
-            && Number.isInteger(options.maxUses) && options.maxUses > 0;
-    }
-    async search(request, signal) {
-        const options = this.resolveOptions();
-        // 读经函数而非直接比属性：TS 会把 `signal?.aborted === true` 早退后的属性
-        // 窄化成 false，后续再判同一属性就成了「无重叠比较」。
-        const isAborted = () => signal?.aborted === true;
-        const endpoint = `${trimTrailingSlash(options.baseURL)}/messages`;
-        const apiKey = await this.apiKey(options, signal);
-        if (isAborted())
-            throw abortedError();
-        const body = {
-            model: options.model,
-            max_tokens: options.maxTokens,
-            messages: [{
-                    role: 'user',
-                    content: [{ type: 'text', text: `Perform a web search for the query: ${request.query}` }],
-                }],
-            tools: [{ type: 'web_search_20250305', name: 'web_search', max_uses: options.maxUses }],
-        };
-        const timeout = AbortSignal.timeout(options.timeoutMs);
-        const composed = signal === undefined ? timeout : AbortSignal.any([signal, timeout]);
-        const doFetch = options.fetchImpl ?? fetch;
-        let response;
-        try {
-            response = await doFetch(endpoint, {
-                method: 'POST',
-                redirect: 'error',
-                headers: {
-                    'x-api-key': apiKey,
-                    'authorization': `Bearer ${apiKey}`,
-                    'anthropic-version': options.apiVersion,
-                    'content-type': 'application/json',
-                    'accept': 'application/json',
-                    'user-agent': USER_AGENT,
-                },
-                body: JSON.stringify(body),
-                signal: composed,
-            });
-        }
-        catch (error) {
-            if (isAborted())
-                throw abortedError();
-            if (timeout.aborted)
-                throw new WebSearchError(`Web search timed out after ${options.timeoutMs} ms at ${JSON.stringify(endpoint)}.`, 'WEB_PROVIDER_ERROR');
-            throw new WebSearchError(`Web search request failed: ${String(error)}.${endpointHint(endpoint)}`, 'WEB_PROVIDER_ERROR');
-        }
-        if (!response.ok) {
-            let detail = '';
-            try {
-                const parsed = await response.json();
-                detail = typeof parsed.error === 'string' ? parsed.error : parsed.error?.message ?? parsed.message ?? '';
-            }
-            catch {
-                // 非 JSON 错误体：状态码已经足够定位。
-            }
-            const message = `Web search endpoint error (HTTP ${response.status})${detail === '' ? '' : `: ${detail}`}`;
-            throw new WebSearchError(`${message}${endpointHint(endpoint)}`, 'WEB_PROVIDER_ERROR');
-        }
-        let mapped;
-        try {
-            mapped = mapSearchResponse(await response.json());
-        }
-        catch (error) {
-            throw new WebSearchError(`Web search returned an unprocessable response body: ${String(error)}`, 'WEB_PROVIDER_ERROR');
-        }
-        if (mapped.resultError !== undefined) {
-            throw new WebSearchError(`The endpoint's web search failed: ${mapped.resultError}.`, 'WEB_PROVIDER_ERROR');
-        }
-        if (mapped.sources.length === 0)
-            throw noResultError(mapped, options);
-        return {
-            ...options.includeAnswer && mapped.content !== undefined && mapped.content !== '' ? { content: mapped.content } : {},
-            sources: mapped.sources,
-            truncated: false,
-        };
-    }
-    /** 解析一次操作的 key：字面 key → 凭据服务 → 环境变量。 */
-    async apiKey(options, signal) {
-        if (signal?.aborted === true)
-            throw abortedError();
-        if (options.apiKey !== undefined && options.apiKey.length > 0)
-            return options.apiKey;
-        const resolved = options.resolveApiKey === undefined ? undefined : await options.resolveApiKey();
-        if (resolved !== undefined && resolved.length > 0)
-            return resolved;
-        const ref = options.apiKeyEnv ?? '';
-        throw new WebSearchError(`Web search has no API key for "${ref === '' ? 'the configured credential reference' : ref}"; store it through the credentials service, `
-            + 'export it in the launching environment, or set a literal "apiKey" in the web-search-kaon config.', 'WEB_PROVIDER_CREDENTIAL_MISSING');
-    }
-}
-/** 调用方取消：与原生 provider 的 `WEB_ABORTED` 对齐。 */
-function abortedError() {
-    return new WebSearchError('Web search aborted', 'WEB_ABORTED');
-}