@sema-agent/client-core 0.77.0 → 0.77.2

package/dist/ultracodeWireCaps.js

@@ -1,109 +1,30 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/ultracodeWireCaps.ts 逐字搬入(零依赖;🔴 模块级 ultracodePreset 是 sticky 单实例态,写口 setUltracodePreset 与读口 ultracodeForWire 必须同实例)。
- */
-/**
- * src/sema/ultracodeWireCaps.ts — the shell's TWO opt-in sources for the CC-parity `settings.ultracode` PRESET,
- * projected onto `TaskRequest.settings.ultracode` (a typed boolean the SERVICE — ai-agent-service 1.48.0 — reads
- * and EXPANDS to `thinking:"max"` + `selfOrchestration:true`; both core's existing orthogonal axes, fail-closed
- * gates unchanged). design/111 (core/search AI 2026-06-30): ultracode is a STANDALONE settings boolean folding
- * "max thinking × workflow orchestration", surfaced in sema as the top notch of the `/effort` dial.
- *
- * Two sources, ONE structured-spec output (`settings.ultracode:true` — never prompt text):
- *
- *  ① L2 dial preset (STICKY): the `/effort ultracode` pick. The effort dial COERCES the reasoning axis to `xhigh`
- *     (overrides/effort.tsx executeEffortSema — "ultracode runs at xhigh effort"), which would LOSE the
- *     orchestration axis. So the dial separately latches this module-level preset: ON when `ultracode` is picked,
- *     OFF when any OTHER effort level is picked (a sticky session setting, like CC's settings.ultracode boolean).
- *
- *  ② L3 keyword (PER-TURN): a client-side scan of the REAL human turn input for the literal word "ultracode".
- *     🔴 RED LINE (design/111 L3, the ONLY injection risk): scan ONLY the human's current-turn submission, BEFORE
- *     any untrusted content (tool results / file reads / web / subagent / MCP) is concatenated. NEVER scan the
- *     assembled prompt server-side — a malicious file containing "ultracode" would be a privilege-escalation
- *     injection. The keyword is a UX convenience switch, NOT a security decision point: privilege STILL passes the
- *     service's fail-closed per-principal `allowWorkflows` gate (core deliberately refuses prompt scanning,
- *     prepare-task.ts:1612 — that boundary is correct). The output is a STRUCTURED spec (the boolean), never
- *     injected prompt text.
- *
- * Both sources are OR'd live-side by `toTaskRequest`; the SAME `SEMA_LIVE_BASEURL` gate the other capability wires
- * use keeps the mock request shape unchanged (the stamp IS the opt-in; absent ⇒ the engine never expands ultracode).
- *
- * The PRESET state is module-level (mirrors seamQuery's seam* injectors): the dial (a React override) latches it,
- * the seam reads it. The KEYWORD scan is a PURE function (caller passes the human input) so it bundles + unit-tests
- * without React/AppState.
- */
 import { hostEnv } from './hostEnv.js';
 import { envFlagOff } from './envFlag.js';
-/** STICKY L2 preset: latched ON by the `/effort ultracode` dial pick, OFF by any other effort pick. Module-level
- *  (one shell process = one session) — the same single-namespace assumption seamQuery's session state uses. */
 let ultracodePreset = false;
-/** Latch the dial preset. `effort.tsx` calls this whenever an effort level is APPLIED: `true` for the `ultracode`
- *  notch, `false` for every other level (so switching the dial OFF ultracode clears the workflow-orchestration axis
- *  while the reasoning axis follows the picked level). */
 export function setUltracodePreset(on) {
     ultracodePreset = on === true;
 }
-/** Read the sticky dial preset (the L2 source). */
 export function getUltracodePreset() {
     return ultracodePreset;
 }
-/** Test/boot reset — clears the latched preset (e.g. a fresh session). */
 export function _resetUltracodePreset() {
     ultracodePreset = false;
 }
-/** Word-boundary, case-insensitive scan for the literal keyword. A bare mention ("ultracode") anywhere in the
- *  human's own turn text counts (CC-style UX toggle); the server's `allowWorkflows` gate is the real guard, so a
- *  false-positive (the user discussing the word) only requests the preset — it cannot escalate past the gate. */
 const ULTRACODE_KEYWORD = /\bultracode\b/i;
-/**
- * L3 keyword source: `true` iff the REAL human turn input contains the "ultracode" keyword, else `undefined`.
- * 🔴 The caller MUST pass ONLY the human's current-turn submission (seamQuery's `objective`, derived from the
- * projectable user message) — NOT any assembled/untrusted content. Returns `true | undefined` (never `false`) to
- * mirror the strict additive-stamp discipline of the other wire caps (a stamped `false` would needlessly change
- * the default request shape).
- */
 export function ultracodeFromInput(humanInput) {
     return typeof humanInput === 'string' && ULTRACODE_KEYWORD.test(humanInput) ? true : undefined;
 }
-/**
- * Combine the two sources into the structured spec the seam stamps. `true` when EITHER the sticky dial preset is on
- * OR the human's current-turn input contains the keyword; otherwise `undefined` (⇒ no stamp ⇒ default behaviour).
- * Returns `true | undefined` so the seam can spread `...(ultracode ? { ultracode } : {})` without changing the
- * default request shape. The CALLER gates this to LIVE mode (mock parity).
- */
 export function ultracodeForRequest(humanInput) {
     return getUltracodePreset() || ultracodeFromInput(humanInput) ? true : undefined;
 }
-/** [1044]②裁 B 激活源 a(clay 拍):用户当轮说 "workflow"(词边界、大小写不敏感)⇒ 该 turn 激活
- *  Workflow 暴露。与 ultracode 线同一注入红线:只扫真人当轮输入(objective),绝不扫组装后内容。
- *  消费接线=[1052]① 收官形(workflowDeferForRequest,core 1.314 deferTools 首班到货后点亮)。
- *  [1486] 词表扩(2026-07-21,「启动 Agent Team 走成三 fork」白盒定谳):多 agent 语义族也激活——
- *  run_workflow 描述里的路由映射句(multi-agent orchestration…fan out agents)defer 后模型读不到,
- *  「agent team/multi-agent/swarm/多agent/编排」类输入落进可见工具面的理性变通(三 fork)。命中即
- *  当轮全量上 wire(翻转只发生在激活当轮,前缀缓存语义不变)。终态=Agent Team 真入口(案A,
- *  [1484]/[1485])落地后此词有真归宿,本词表是过渡补丁。 */
 const WORKFLOW_KEYWORD = /\bworkflows?\b|\bagent[ -]?teams?\b|\bmulti[ -]?agent\b|\bswarms?\b|多\s?agent|多智能体|编排/i;
 export function workflowFromInput(humanInput) {
     return typeof humanInput === 'string' && WORKFLOW_KEYWORD.test(humanInput) ? true : undefined;
 }
-/** Env escape hatch for the deferred-Workflow factory default: `SEMA_WORKFLOW_DEFER=0/false/no/off` restores the
- *  pre-[1052] always-exposed shape (schema bytes back in the prefix). Anything else (incl. unset) = defer ON. */
 const WORKFLOW_DEFER_ENV = 'SEMA_WORKFLOW_DEFER';
-/** 拼写集 = {@link envFlagOff}(REF-CC-141 dup-02 单源)。 */
 function deferOptedOut(env) {
     return envFlagOff(env[WORKFLOW_DEFER_ENV]);
 }
-/**
- * [1052]① 收官形(clay 裁 B 的 core deferred 机制件,cli 接线半场):Workflow「全局默认开但不暴露」——
- * 未命中激活源的 TaskRequest 带 `deferTools:["Workflow"]`(core 1.314 对已挂载工具做 design/36 延迟披露:
- * 占位符上 wire、schema 字节撤出缓存前缀、ToolSearch 可激活=中途激活通路);命中任一激活源 ⇒ `undefined`
- * (不 defer=名字+schema 全量上 wire):
- *   a) 用户当轮说 "workflow"(workflowFromInput,只扫真人输入);
- *   b) "ultracode" 关键词(L3,同一红线);
- *   c) `/effort ultracode` sticky dial(L2 preset)。
- * CALLER 前置两门:live 门(mock 形不变)+ selfOrchestration stamp 存在(opt-out 时 Workflow 根本不挂载,
- * defer 无意义)。前缀缓存注记:defer↔不 defer 的翻转只发生在真人激活当轮,与 CC 209 ToolSearch materialize
- * 同一形——非激活轮的前缀指纹稳定([1044]② clay 硬约束 ii 的解)。
- */
 export function workflowDeferForRequest(humanInput, env = hostEnv()) {
     if (deferOptedOut(env))
         return undefined;
@@ -111,13 +32,8 @@ export function workflowDeferForRequest(humanInput, env = hostEnv()) {
         return undefined;
     return ['Workflow'];
 }
-/** [1077]④ 低频工具惰性注入:`SEMA_DEFER_TOOLS=<csv>`(wire 名)追加进 deferTools(core 1.314
- *  延迟披露腿)。**缺省翻转已裁(clay [1212]⑤,2026-07-19)**:九件低频工具缺省 defer——判决数=
- *  -2,484 tok/首调用+多轮 gate 零行为退化;defer≠禁用(占位符在,模型 ToolSearch 随取)。
- *  逃生门:`SEMA_DEFER_LOWFREQ=0/false/no/off` 关缺省名单(九件恢复全量上前缀)。 */
 export const DEFER_TOOLS_ENV = 'SEMA_DEFER_TOOLS';
 export const DEFER_LOWFREQ_ENV = 'SEMA_DEFER_LOWFREQ';
-/** clay 裁定的缺省惰性名单([1076]④ 评测九件原单,[1090]② 判决数)。 */
 export const DEFAULT_LOWFREQ_DEFER = [
     'Glob',
     'Grep',
@@ -138,17 +54,9 @@ function extraDeferFromEnv(env) {
         .map((s) => s.trim())
         .filter((s) => s.length > 0);
 }
-/** 拼写集 = {@link envFlagOff}(REF-CC-141 dup-02 单源)。 */
 function lowFreqOptedOut(env) {
     return envFlagOff(env[DEFER_LOWFREQ_ENV]);
 }
-/**
- * The FULL deferTools list for a request: the Workflow default-defer lane (activation sources, see
- * {@link workflowDeferForRequest}) + the DEFAULT low-frequency list (clay [1212]⑤, opt-out via
- * SEMA_DEFER_LOWFREQ) + the SEMA_DEFER_TOOLS extra list, deduped. An activation hit removes ONLY
- * Workflow (the user asked for it by name); the other lanes are source-independent. Empty ⇒
- * `undefined` (no stamp, request shape unchanged).
- */
 export function deferToolsForRequest(humanInput, env = hostEnv()) {
     const workflowLane = workflowDeferForRequest(humanInput, env) ?? [];
     const lowFreqLane = lowFreqOptedOut(env) ? [] : DEFAULT_LOWFREQ_DEFER;

package/dist/unrefTimer.d.ts

@@ -1,30 +1,3 @@
-/**
- * unrefTimer — 域词表-14 收编:「在没有 unref 的宿主(浏览器/桌面渲染进程)上不炸,在 Node 上
- * 不阻止进程退出」这条可移植性不变量此前有 5 份各写各的手抄(三种写法:直接可选调用 /
- * 先 `as unknown` 再可选调用 / 先 `typeof … === 'function'` 判断再可选调用)。本函数统一成一份。
- *
- * 🔴 这是**低层原语**,不是策略:本函数只统一「怎么调 unref」,不统一「该不该 unref」——
- * 该不该 unref 是调用点的控制流判断,必须留在各处决定。域词表-13 定谳:被 await 的 race/budget
- * 臂上的定时器绝不能 unref(会让进程在它 settle 前提前退出,RB-447 同形)——
- * `agentsWireCaps.ts` 的 `awaitTaskAgentsWire` 那处是控制流臂而非后台保活豁免,**不调用本函数**。
- *
- * 泛型约束到定时器句柄型(`setTimeout`/`setInterval` 的回传值):本包 `"types": []` + 默认 DOM
- * lib 下两者都是 `number`,Node 运行时实际回传 `Timeout` 对象——真身与编译期类型不一致正是
- * `unref?.()` 需要可选调用的原因。约束此前是无约束 `<T>`,任何东西都能传进来。
- *
- * 🔴 这条约束**挡得住哪一半、挡不住哪一半**(实测,不是承诺 —— [2393] F-3 纠正:此前这里写的是
- *    「`unrefTimer(42)` / `unrefTimer(aPromise)` 收窄后编译期就报」,而上一段自己写明的前提
- *    「本包下句柄型就是 `number`」直接推翻了它的前半句):
- *      · `unrefTimer('x')` / `unrefTimer(aPromise)` —— **编译期红**(TS2345,非 number 挡得住);
- *      · `unrefTimer(42)` —— **编译期绿**。`42` 与真句柄在本包的类型系统里不可分辨,挡不住;
- *        运行时也无害(可选调用在 number 上是 no-op),但别指望编译器替你抓这一类打错。
- *    这四条判决由 `scripts/run-client-core-typeshape-test.mjs` 的 D 腿每跑机械核一次:实测与
- *    这段措辞一旦分叉即红。⚠️ 别为了兑现前半句去拧类型 —— 能挡住数字字面量的写法在**装了
- *    @types/node 的下游**会把句柄型解成 `Timeout` 对象,五个真调用点全线编译红(用一个假承诺
- *    换一个真的可移植性回归)。
- *
- * 五个既有调用点(均传 `setTimeout`/`setInterval` 的返回值)不受约束影响。
- */
 type TimerLikeHandle = ReturnType<typeof setTimeout> | ReturnType<typeof setInterval>;
 export declare function unrefTimer<T extends TimerLikeHandle>(t: T): T;
 export {};

package/dist/webSearchBackendCapability.d.ts

@@ -1,48 +1,7 @@
-/**
- * webSearchBackendCapability — **部署默认 WebSearch 后端**的三端共用读面(0.72.5;server ≥7.82.1 / S-382
- * 的 `GET /v1/capabilities.webSearch`,契约附录 B.1;sdk 9.6.0 的 `Capabilities` 尚未声明该键)。
- *
- * ── 这一格答的是哪一个问题 ────────────────────────────────────────────────────────────────
- * 「我的工具面里为什么只有 WebFetch、没有 WebSearch?」装不装 WebSearch 工具由两个互不相干的旋钮决定:
- *   ① 引擎**部署**自己的默认后端(`WEB_SEARCH_PROVIDER`;是 provider 词表之一才装配);
- *   ② 调用方盖在请求上的 `settings.webSearch`(本包 `webSearchWireCaps` 投影;单用户车道上压过 ①)。
- * 本格只广告 **①**:server 逐字「广告的是部署默认,不是这次调用有没有搜索」—— 每请求覆盖**刻意不回显**
- * (回显等于让能力面随调用方漂)。所以 `none` 与「这次任务没有 WebSearch 工具」**不等价**:单用户车道上调用方
- * 自带 `settings.webSearch` 时工具照常装配,而本格仍读 `none`。消费端渲这一行时两段各渲各的,绝不互推。
- *
- * ── 🔴 四态,不是两态([honest-absence-not-fabricated-zero])──────────────────────────────────
- * 与 `sqlEngineCapability` / `writeProtectionCapability` 逐字同一套词汇(通用读口 `engineCapValue` 答「这一格
- * 上有没有值」,窄读器答「值成不成形」):
- *   ① `unobserved`   —— **本进程一次 caps 响应都没观测到**(一次性 doctor 就是这一档)。
- *   ② `not_reported` —— caps 观测到了,而回体上**没有** `webSearch` 这个键 ⇒ 老引擎(<7.82.1)。
- *      🔴 契约逐字:**不许读作「本部署没有后端」** —— 那是 `"none"` 在说的话;两者的处置相反(一个渲
- *      「不可用」,一个渲「判不了」)。老引擎上只能按改前的办法判(跑一个真任务 / 读引擎启动日志)。
- *   ③ `none`         —— 引擎**明确说** `backend: "none"`:本部署没有默认搜索后端(`WEB_SEARCH_PROVIDER`
- *      未设 / 拼错)。**正面事实**,不是缺席;调用方没自带配置时默认场景**不装配** WebSearch 工具。
- *   ④ `present`      —— 一个 provider 词,原样渲。
- *
- * ── 🔴 窄读域只许等于或宽于铸点域 ────────────────────────────────────────────────────────────
- * server 的闭集**取型**自它的 provider 元组(加一只后端那一位自动跟着长)。本包**不**手抄那三个词当判据:
- * 抄一份就是给自己立第二个判官 —— 上游哪天加一只后端,手抄的那份会把新词判成畸形、把一台配好了的部署
- * 渲成「读不出」(消费域比铸点域更窄的病形,S-131 那一格已经付过一次代价)。`backend` 按**非空串**读,
- * 只有 `"none"` 这一个词带独立语义;别的词一律 `present` 并按 UNTRUSTED-for-display 消毒封长后上屏。
- *
- * ── 🔴 与 SQL 那一格的一处刻意不同:`webSearch: null` 是畸形 ────────────────────────────────
- * SQL 位的铸点会铸 `null`(「没有 SQL 后端」),所以那边 `null ⇒ none`。本位的铸点**永远铸一个对象**
- * (provider 缺席时铸 `{ backend: "none" }`,不铸 `null`)⇒ wire 上出现 `null` 不是任何一种已知读数,
- * 按畸形处置(删格 ⇒ `unobserved`),不替它编一个「none」。
- *
- * ── 与能力位台账门的关系 ───────────────────────────────────────────────────────────────────
- * `run-engine-caps-ledger-test.mjs` 的台账按 sdk `Capabilities` 键集对表;sdk 今天还没声明 `webSearch`,
- * 所以台账**刻意没有**这一行。sdk 出键当天该门自动红,逼一次显式处置(登 `read` 行指向本文件)。
- */
-/** `backend: "none"` —— 唯一带独立语义的词(见文件头);其余词按开集读。 */
 export declare const WEB_SEARCH_BACKEND_NONE = "none";
-/** `present` 时的读数:部署默认后端的 provider 词(开集;`"none"` 不会出现在这里 —— 它是 `none` 档)。 */
 export interface WebSearchBackendCapabilityView {
     backend: string;
 }
-/** 四态读数(见文件头)。`unobserved` 由**读口**在这一格空缺时铸,不由投影铸。 */
 export type WebSearchBackendReading = {
     kind: 'unobserved';
 } | {
@@ -53,42 +12,11 @@ export type WebSearchBackendReading = {
     kind: 'present';
     view: WebSearchBackendCapabilityView;
 };
-/**
- * caps 回体 → 本格读数;**畸形一律 `undefined`**(= 这一格不写 ⇒ 读口答 `unobserved`)。
- *
- * 🔴 键不在(`undefined`)⇒ `not_reported`(老引擎);`null` ⇒ 畸形(本位铸点从不铸 `null`,见文件头)。
- * 🔴 `backend` 不是非空串 ⇒ 整条畸形;`"none"` ⇒ `none`;其余词 ⇒ `present`(开集,不手抄闭集)。
- * 🔴 对象上的**多余成员不过境**(本包只读 `backend`;端点 / 密钥 / 配额契约上一个字都不上 wire,
- *    真出现了也不是本读面该带出去的东西)。
- */
 export declare function projectWebSearchBackendCapability(caps: unknown): WebSearchBackendReading | undefined;
-/**
- * 宿主 caps probe 的**读面 tee** 落点(与 `noteEngineCapsForSqlEngine` / `noteEngineCapsForWriteProtection`
- * 并列;宿主在同一处按序调三只)。绝不 throw —— 读面腿不许反噬 caps 探测链。
- *
- * 🔴 投影 `undefined`(caps 畸形)⇒ 这一格**被删**而不是留着上一台引擎的旧值。
- * 🔴 **不按 principal 分域**:部署默认后端是**这台 worker 的 boot 产物**,与调用者是谁无关。
- * 🔴 `opts.generation` = 关掉「旧探测覆盖新读数」竞态的唯一正确供给(与两只兄弟逐字同律):宿主在起探测
- *    那一刻 `engineCapsGeneration(baseUrl)` 抓号、在这里原样交回,陈旧那一发整只丢掉;不传 ⇒ 照写。
- */
 export declare function noteEngineCapsForWebSearchBackend(baseUrl: string, caps: unknown, opts?: {
     generation?: number;
 }): void;
-/** 本进程观测到的部署默认后端;这一格空缺 ⇒ `{kind:'unobserved'}`(**绝不**折成 `none`)。 */
 export declare function observedWebSearchBackend(baseUrl?: string | undefined): WebSearchBackendReading;
-/**
- * 四态 → doctor 那一行「部署默认后端」这一段的 detail 串。**唯一措辞真源**(三端共用;端只拼接不另写)。
- *
- * 🔴 四句话刻意**互不相同、也互不蕴含**:「未观测」「老引擎不报」两种「读不出」都**不等于**「没有后端」;
- *    `none` 那一句必须同时说出两件事 —— 部署默认场景不装配这只工具,**以及**调用方自带配置仍可装配
- *    (契约 🔴 蕴含只对「没自带配置」那一形成立)。少说后半句,用户会在 `/websearch` 配好之后仍以为没用。
- * 🔴 `present` 只渲 provider 一个词(消毒 + 封长);每请求覆盖不在此回显 —— 那是请求方自己送进来的。
- */
 export declare function webSearchBackendDoctorDetail(reading: WebSearchBackendReading): string;
-/**
- * **换代失效口**(与 `forgetSqlEngineReading` / `forgetWriteProtectionReading` 并列,由宿主在引擎温切成功后调)。
- * 处置是**清成未观测**,不是留旧值也不是铸一个 `none`。空串 ⇒ no-op;绝不 throw。
- */
 export declare function forgetWebSearchBackendReading(baseUrl: string | undefined): void;
-/** 测试钩子。 */
 export declare function __resetWebSearchBackendReadingsForTests(): void;

package/dist/webSearchBackendCapability.js

@@ -1,59 +1,10 @@
-/**
- * webSearchBackendCapability — **部署默认 WebSearch 后端**的三端共用读面(0.72.5;server ≥7.82.1 / S-382
- * 的 `GET /v1/capabilities.webSearch`,契约附录 B.1;sdk 9.6.0 的 `Capabilities` 尚未声明该键)。
- *
- * ── 这一格答的是哪一个问题 ────────────────────────────────────────────────────────────────
- * 「我的工具面里为什么只有 WebFetch、没有 WebSearch?」装不装 WebSearch 工具由两个互不相干的旋钮决定:
- *   ① 引擎**部署**自己的默认后端(`WEB_SEARCH_PROVIDER`;是 provider 词表之一才装配);
- *   ② 调用方盖在请求上的 `settings.webSearch`(本包 `webSearchWireCaps` 投影;单用户车道上压过 ①)。
- * 本格只广告 **①**:server 逐字「广告的是部署默认,不是这次调用有没有搜索」—— 每请求覆盖**刻意不回显**
- * (回显等于让能力面随调用方漂)。所以 `none` 与「这次任务没有 WebSearch 工具」**不等价**:单用户车道上调用方
- * 自带 `settings.webSearch` 时工具照常装配,而本格仍读 `none`。消费端渲这一行时两段各渲各的,绝不互推。
- *
- * ── 🔴 四态,不是两态([honest-absence-not-fabricated-zero])──────────────────────────────────
- * 与 `sqlEngineCapability` / `writeProtectionCapability` 逐字同一套词汇(通用读口 `engineCapValue` 答「这一格
- * 上有没有值」,窄读器答「值成不成形」):
- *   ① `unobserved`   —— **本进程一次 caps 响应都没观测到**(一次性 doctor 就是这一档)。
- *   ② `not_reported` —— caps 观测到了,而回体上**没有** `webSearch` 这个键 ⇒ 老引擎(<7.82.1)。
- *      🔴 契约逐字:**不许读作「本部署没有后端」** —— 那是 `"none"` 在说的话;两者的处置相反(一个渲
- *      「不可用」,一个渲「判不了」)。老引擎上只能按改前的办法判(跑一个真任务 / 读引擎启动日志)。
- *   ③ `none`         —— 引擎**明确说** `backend: "none"`:本部署没有默认搜索后端(`WEB_SEARCH_PROVIDER`
- *      未设 / 拼错)。**正面事实**,不是缺席;调用方没自带配置时默认场景**不装配** WebSearch 工具。
- *   ④ `present`      —— 一个 provider 词,原样渲。
- *
- * ── 🔴 窄读域只许等于或宽于铸点域 ────────────────────────────────────────────────────────────
- * server 的闭集**取型**自它的 provider 元组(加一只后端那一位自动跟着长)。本包**不**手抄那三个词当判据:
- * 抄一份就是给自己立第二个判官 —— 上游哪天加一只后端,手抄的那份会把新词判成畸形、把一台配好了的部署
- * 渲成「读不出」(消费域比铸点域更窄的病形,S-131 那一格已经付过一次代价)。`backend` 按**非空串**读,
- * 只有 `"none"` 这一个词带独立语义;别的词一律 `present` 并按 UNTRUSTED-for-display 消毒封长后上屏。
- *
- * ── 🔴 与 SQL 那一格的一处刻意不同:`webSearch: null` 是畸形 ────────────────────────────────
- * SQL 位的铸点会铸 `null`(「没有 SQL 后端」),所以那边 `null ⇒ none`。本位的铸点**永远铸一个对象**
- * (provider 缺席时铸 `{ backend: "none" }`,不铸 `null`)⇒ wire 上出现 `null` 不是任何一种已知读数,
- * 按畸形处置(删格 ⇒ `unobserved`),不替它编一个「none」。
- *
- * ── 与能力位台账门的关系 ───────────────────────────────────────────────────────────────────
- * `run-engine-caps-ledger-test.mjs` 的台账按 sdk `Capabilities` 键集对表;sdk 今天还没声明 `webSearch`,
- * 所以台账**刻意没有**这一行。sdk 出键当天该门自动红,逼一次显式处置(登 `read` 行指向本文件)。
- */
 import { capForDisplay } from './fleetTaskDesc.js';
 import { engineWireTarget } from './engineWireTarget.js';
 import { createEngineCapReader } from './engineCapReader.js';
-/** `backend: "none"` —— 唯一带独立语义的词(见文件头);其余词按开集读。 */
 export const WEB_SEARCH_BACKEND_NONE = 'none';
-/**
- * caps 回体 → 本格读数;**畸形一律 `undefined`**(= 这一格不写 ⇒ 读口答 `unobserved`)。
- *
- * 🔴 键不在(`undefined`)⇒ `not_reported`(老引擎);`null` ⇒ 畸形(本位铸点从不铸 `null`,见文件头)。
- * 🔴 `backend` 不是非空串 ⇒ 整条畸形;`"none"` ⇒ `none`;其余词 ⇒ `present`(开集,不手抄闭集)。
- * 🔴 对象上的**多余成员不过境**(本包只读 `backend`;端点 / 密钥 / 配额契约上一个字都不上 wire,
- *    真出现了也不是本读面该带出去的东西)。
- */
 export function projectWebSearchBackendCapability(caps) {
     if (caps === null || typeof caps !== 'object')
         return undefined;
-    // 0.77.0 整族改齐:① 非对象 / 数组 caps 不是能力表 ⇒ 畸形(投影答 undefined ⇒ 删格 ⇒ 读口答 unobserved),不再答 not_reported
-    //    (那是把「取不到」冒充「报了但没提」);② 在场判据改 hasOwn —— 原型链上的同名键永远不会被序列化上 wire,读成在场 = 凭空造一格。
     if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
         return undefined;
     if (!Object.hasOwn(caps, 'webSearch'))
@@ -70,44 +21,19 @@ export function projectWebSearchBackendCapability(caps) {
         return { kind: 'none' };
     return { kind: 'present', view: { backend } };
 }
-/**
- * 本格的 per-baseUrl 读账 + tee / 读口 / 失效口 / 测试钩四口 —— 各只能力位读器**共用同一份实现**
- * ({@link createEngineCapReader});本文件只留这一格真正不同的部分:投影函数 {@link projectWebSearchBackendCapability}、doctor 措辞表,以及本位自己的判据助手(如有)。
- * 🔴 Map 在工厂闭包里,**一只读器一张**:收到读不懂的回体只删自己这一格,绝不连坐别的能力面。
- */
 const reader = createEngineCapReader({
     name: 'webSearch.backend',
     project: projectWebSearchBackendCapability,
     makeUnobserved: () => ({ kind: 'unobserved' }),
 });
-/**
- * 宿主 caps probe 的**读面 tee** 落点(与 `noteEngineCapsForSqlEngine` / `noteEngineCapsForWriteProtection`
- * 并列;宿主在同一处按序调三只)。绝不 throw —— 读面腿不许反噬 caps 探测链。
- *
- * 🔴 投影 `undefined`(caps 畸形)⇒ 这一格**被删**而不是留着上一台引擎的旧值。
- * 🔴 **不按 principal 分域**:部署默认后端是**这台 worker 的 boot 产物**,与调用者是谁无关。
- * 🔴 `opts.generation` = 关掉「旧探测覆盖新读数」竞态的唯一正确供给(与两只兄弟逐字同律):宿主在起探测
- *    那一刻 `engineCapsGeneration(baseUrl)` 抓号、在这里原样交回,陈旧那一发整只丢掉;不传 ⇒ 照写。
- */
 export function noteEngineCapsForWebSearchBackend(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
 }
-/** 本进程观测到的部署默认后端;这一格空缺 ⇒ `{kind:'unobserved'}`(**绝不**折成 `none`)。 */
 export function observedWebSearchBackend(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
-/** provider 词的展示上限(UTF-16 单元;与两只兄弟同值同理由 —— 开集词按 UNTRUSTED-for-display 处置)。 */
 const WS_DETAIL_MAX = 40;
-/** 部署侧那个旋钮的名字 —— 用户要去改的就是它,所以逐字写出来而不是说「部署配置」。 */
 const DEPLOY_ENV = 'WEB_SEARCH_PROVIDER';
-/**
- * 四态 → doctor 那一行「部署默认后端」这一段的 detail 串。**唯一措辞真源**(三端共用;端只拼接不另写)。
- *
- * 🔴 四句话刻意**互不相同、也互不蕴含**:「未观测」「老引擎不报」两种「读不出」都**不等于**「没有后端」;
- *    `none` 那一句必须同时说出两件事 —— 部署默认场景不装配这只工具,**以及**调用方自带配置仍可装配
- *    (契约 🔴 蕴含只对「没自带配置」那一形成立)。少说后半句,用户会在 `/websearch` 配好之后仍以为没用。
- * 🔴 `present` 只渲 provider 一个词(消毒 + 封长);每请求覆盖不在此回显 —— 那是请求方自己送进来的。
- */
 export function webSearchBackendDoctorDetail(reading) {
     switch (reading.kind) {
         case 'unobserved':
@@ -125,14 +51,9 @@ export function webSearchBackendDoctorDetail(reading) {
                 '(per-request overrides are not echoed here)');
     }
 }
-/**
- * **换代失效口**(与 `forgetSqlEngineReading` / `forgetWriteProtectionReading` 并列,由宿主在引擎温切成功后调)。
- * 处置是**清成未观测**,不是留旧值也不是铸一个 `none`。空串 ⇒ no-op;绝不 throw。
- */
 export function forgetWebSearchBackendReading(baseUrl) {
     reader.forget(baseUrl);
 }
-/** 测试钩子。 */
 export function __resetWebSearchBackendReadingsForTests() {
     reader.__resetForTests();
 }

package/dist/webSearchWireCaps.d.ts

@@ -1,54 +1,17 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/webSearchWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/webSearchWireCaps.ts — PURE projection: the shell's WebSearch backend config → the @sema-ai
- * `SemaSettings.webSearch` wire shape carried on `TaskRequest.settings.webSearch`.
- *
- * The SERVICE consumes `body.settings.webSearch` — ai-agent-service `src/plugins/web-search.ts`
- * `webSearchConfigFromSettings(raw)` reads a per-request `{ provider, apiKey?, endpoint?, maxResults? }` that
- * WINS over the deployment-env backend, gated to the single-user host lane (a per-request endpoint/apiKey is a
- * capability config; on multi-tenant it would be SSRF, so multi-tenant uses ONLY the deploy-env backend —
- * design/107). The service validates `provider ∈ brave | tavily | searxng` and DROPS a missing/invalid provider
- * (it never throws — a bad config falls back to the deploy-env backend). We mirror that exact validation here so
- * the shell never stamps a config the service would reject.
- *
- * Two config sources, ENV wins (the primary / verify lane):
- *   - ENV: `SEMA_WEBSEARCH_PROVIDER` / `_ENDPOINT` / `_API_KEY` / `_MAX_RESULTS` (SEMA_-namespaced, distinct from
- *     the SERVICE's own deploy `WEB_SEARCH_*` env so the shell config never collides with the worker's).
- *   - settings.json: a CC-parity `webSearch` section (the SettingsSchema outer `.passthrough()` preserves it).
- *
- * PURE — no env/file IO of its OWN (callers pass `env` / `raw`), so it bundles + unit-tests without the heavy
- * settings graph, exactly like mcpWireCaps. The CALLER (seamQuery / seamQueryEngine) gates the env read to LIVE
- * mode so the mock request shape never changes; webSearch presence IS the opt-in (no extra flag needed).
- */
 import { type EnvLike } from './hostEnv.js';
-/** The search providers the service backend speaks (web-search.ts `WebSearchProvider`). */
 export type WebSearchProvider = 'brave' | 'tavily' | 'searxng';
-/** The `SemaSettings.webSearch` wire shape — mirrors the service's per-request parser input
- *  (web-search.ts `webSearchConfigFromSettings`: `{ provider, apiKey?, endpoint?, maxResults? }`). */
 export interface WebSearchSettings {
     provider: WebSearchProvider;
-    /** API key (brave/tavily). The service keeps it in a closure — it never reaches the model or the tool args. */
     apiKey?: string;
-    /** SearXNG base URL (REQUIRED for searxng); for brave/tavily an optional base-URL override. */
     endpoint?: string;
-    /** Max results returned to the model (the service clamps 1..20; default 10). */
     maxResults?: number;
 }
-/** The four env keys the shell reads. SEMA_-namespaced so they never collide with the worker's deploy
- *  `WEB_SEARCH_*` env (the service reads BOTH — a per-request body.settings.webSearch WINS over its env). */
 export declare const WEBSEARCH_ENV: {
     readonly provider: "SEMA_WEBSEARCH_PROVIDER";
     readonly endpoint: "SEMA_WEBSEARCH_ENDPOINT";
     readonly apiKey: "SEMA_WEBSEARCH_API_KEY";
     readonly maxResults: "SEMA_WEBSEARCH_MAX_RESULTS";
 };
-/** ENV source → WebSearchSettings, or undefined when no/invalid provider (⇒ no stamp; service uses its env/none). */
 export declare function webSearchFromEnv(env?: EnvLike): WebSearchSettings | undefined;
-/** settings.json `webSearch` section (UNTRUSTED passthrough value) → WebSearchSettings, mirroring the service's
- *  `webSearchConfigFromSettings`. Missing/invalid provider ⇒ undefined (omit). NEVER throws. */
 export declare function webSearchFromSettings(raw: unknown): WebSearchSettings | undefined;
-/** Resolve the effective WebSearch config: ENV wins (the primary lane), else the settings.json section.
- *  Undefined ⇒ no stamp (the service falls back to its deploy-env backend, or ships no WebSearch tool). */
 export declare function resolveWebSearch(env?: EnvLike, settingsRaw?: unknown): WebSearchSettings | undefined;

package/dist/webSearchWireCaps.js

@@ -1,47 +1,18 @@
-/**
- * ⇄ B2 批搬迁(2026-07-27,多端改造设计稿 §3 B2):cli src/sema/webSearchWireCaps.ts 逐字搬入(零依赖)。
- */
-/**
- * src/sema/webSearchWireCaps.ts — PURE projection: the shell's WebSearch backend config → the @sema-ai
- * `SemaSettings.webSearch` wire shape carried on `TaskRequest.settings.webSearch`.
- *
- * The SERVICE consumes `body.settings.webSearch` — ai-agent-service `src/plugins/web-search.ts`
- * `webSearchConfigFromSettings(raw)` reads a per-request `{ provider, apiKey?, endpoint?, maxResults? }` that
- * WINS over the deployment-env backend, gated to the single-user host lane (a per-request endpoint/apiKey is a
- * capability config; on multi-tenant it would be SSRF, so multi-tenant uses ONLY the deploy-env backend —
- * design/107). The service validates `provider ∈ brave | tavily | searxng` and DROPS a missing/invalid provider
- * (it never throws — a bad config falls back to the deploy-env backend). We mirror that exact validation here so
- * the shell never stamps a config the service would reject.
- *
- * Two config sources, ENV wins (the primary / verify lane):
- *   - ENV: `SEMA_WEBSEARCH_PROVIDER` / `_ENDPOINT` / `_API_KEY` / `_MAX_RESULTS` (SEMA_-namespaced, distinct from
- *     the SERVICE's own deploy `WEB_SEARCH_*` env so the shell config never collides with the worker's).
- *   - settings.json: a CC-parity `webSearch` section (the SettingsSchema outer `.passthrough()` preserves it).
- *
- * PURE — no env/file IO of its OWN (callers pass `env` / `raw`), so it bundles + unit-tests without the heavy
- * settings graph, exactly like mcpWireCaps. The CALLER (seamQuery / seamQueryEngine) gates the env read to LIVE
- * mode so the mock request shape never changes; webSearch presence IS the opt-in (no extra flag needed).
- */
 import { hostEnv } from './hostEnv.js';
-/** The four env keys the shell reads. SEMA_-namespaced so they never collide with the worker's deploy
- *  `WEB_SEARCH_*` env (the service reads BOTH — a per-request body.settings.webSearch WINS over its env). */
 export const WEBSEARCH_ENV = {
     provider: 'SEMA_WEBSEARCH_PROVIDER',
     endpoint: 'SEMA_WEBSEARCH_ENDPOINT',
     apiKey: 'SEMA_WEBSEARCH_API_KEY',
     maxResults: 'SEMA_WEBSEARCH_MAX_RESULTS',
 };
-/** Validate a provider EXACTLY as the service does (trim + lowercase; only the three known providers). */
 function normProvider(v) {
     const p = typeof v === 'string' ? v.trim().toLowerCase() : '';
     return p === 'brave' || p === 'tavily' || p === 'searxng' ? p : undefined;
 }
-/** Parse a positive integer maxResults (string env or number); undefined when absent/invalid (service clamps). */
 function normMax(v) {
     const n = typeof v === 'number' ? v : Number(v);
     return Number.isFinite(n) && n > 0 ? Math.floor(n) : undefined;
 }
-/** Assemble a `WebSearchSettings`, omitting empty optionals (never stamp `apiKey:''`/`endpoint:''`/`maxResults:0`). */
 function build(provider, apiKey, endpoint, maxResults) {
     const max = normMax(maxResults);
     return {
@@ -51,15 +22,12 @@ function build(provider, apiKey, endpoint, maxResults) {
         ...(max ? { maxResults: max } : {}),
     };
 }
-/** ENV source → WebSearchSettings, or undefined when no/invalid provider (⇒ no stamp; service uses its env/none). */
 export function webSearchFromEnv(env = hostEnv()) {
     const provider = normProvider(env[WEBSEARCH_ENV.provider]);
     if (!provider)
         return undefined;
     return build(provider, env[WEBSEARCH_ENV.apiKey], env[WEBSEARCH_ENV.endpoint], env[WEBSEARCH_ENV.maxResults]);
 }
-/** settings.json `webSearch` section (UNTRUSTED passthrough value) → WebSearchSettings, mirroring the service's
- *  `webSearchConfigFromSettings`. Missing/invalid provider ⇒ undefined (omit). NEVER throws. */
 export function webSearchFromSettings(raw) {
     if (!raw || typeof raw !== 'object')
         return undefined;
@@ -69,8 +37,6 @@ export function webSearchFromSettings(raw) {
         return undefined;
     return build(provider, s.apiKey, s.endpoint, s.maxResults);
 }
-/** Resolve the effective WebSearch config: ENV wins (the primary lane), else the settings.json section.
- *  Undefined ⇒ no stamp (the service falls back to its deploy-env backend, or ships no WebSearch tool). */
 export function resolveWebSearch(env = hostEnv(), settingsRaw) {
     return webSearchFromEnv(env) ?? webSearchFromSettings(settingsRaw);
 }

package/dist/websearch/searchProviderPresets.d.ts

@@ -1,81 +1,18 @@
-/**
- * searchProviderPresets.ts — **搜索 provider 目录**(三端复用:CLI / web / 桌面同吃一份)。
- *
- * ## 它是什么、不是什么
- *
- * 与 `model/providerPresets.{ts,json}` **同形不同表**:数据在同名 `.json`(加一家 = 加一行,不改码),
- * 类型与查询函数在本文件。区别在于它编译出来的不是「模型目录」而是**引擎的部署 env**:
- *
- * | env 键 | 取值 | 缺席时 |
- * |---|---|---|
- * | `WEB_SEARCH_PROVIDER` | `brave` / `tavily` / `searxng` | 🔴 **引擎根本不挂 WebSearch 工具** |
- * | `WEB_SEARCH_API_KEY` | brave/tavily 必填;searxng 不需要 | — |
- * | `WEB_SEARCH_ENDPOINT` | searxng 必填;brave/tavily 是可选 base-URL 覆盖 | 用厂商默认地址 |
- * | `WEB_SEARCH_MAX_RESULTS` | 1..20 | 引擎默认 10 |
- * | `WEB_SEARCH_TIMEOUT_MS` | 正整数毫秒 | 引擎默认 10000 |
- *
- * 🔴 `WEB_SEARCH_ENDPOINT` 的语义是「**引擎**可达的地址」,不是用户机器可达 —— 云端引擎 + 用户
- * 内网的 SearXNG(`http://searxng.lan:8080`)是配得上但**跑不通**的组合,端在这一格要提醒用户
- * 按引擎所在网络填。本模块只做形校验,拨不拨得通是引擎那一侧的事(本包零网络)。
- *
- * ## 与 `webSearchWireCaps.ts` 的分工(两条不同的车道,别混)
- *
- * · `webSearchWireCaps` = **每请求**的 `TaskRequest.settings.webSearch`(单用户宿主车道,
- *   服务端 `web-search.ts` 读它、且它压过部署 env);
- * · 本文件 = **部署 env** 那一侧的编译器(引擎进程启动时吃的 `WEB_SEARCH_*`)。
- *   provider 枚举是**同一个**类型(`WebSearchProvider` 从 wireCaps 单向 import),绝不在这里
- *   再声明一份 —— 两份枚举漂了编译器永远不会告诉你([多端 wire 契约单一真源])。
- *
- * ## 三条硬纪律(pure 门 WS 段逐条有断言)
- *
- * 1. 🔴 **用户没配 ⇒ 一个键都不产出**。`buildWebSearchEnv({})` 恒返回 `{}`,尤其**绝不**产出
- *    `WEB_SEARCH_PROVIDER: ''` 这类空串键 —— 引擎读到「键在场」就会当作配了,一个空串能把
- *    「没开搜索」变成「开了一个必然失败的搜索」。空串比缺席更坏,因为它撒谎。
- * 2. 🔴 **不替用户填默认值**。`maxResults`/`timeoutMs` 用户没选就不出键,让引擎用自己的默认
- *    (`WEB_SEARCH_ENGINE_DEFAULTS` 只供端**显示**「默认 10」)。客户端把当下的引擎默认值钉进
- *    env,等于引擎哪天改默认值,所有老客户端都在静默压制它。
- * 3. 🔴 **不可用的配置一律 fail-closed 且可观测**:缺 key / 缺 endpoint / 数值越界 ⇒
- *    `buildWebSearchEnv` 返回 `{}`(宁可不挂工具,也不挂一个必然报错的工具),同时
- *    `validateWebSearchChoice` 给出**具体** reason 供端渲提示 —— 「静默什么都不做」在本层
- *    必须是可解释的([honest-absence-not-fabricated-zero])。
- *
- * ## URL 位的诚实缺席
- *
- * `consoleUrl`/`signupUrl` 会被端直接拿去开浏览器,编一个 = 把用户送到错误的地方。故只填能可靠
- * 确认的官方位;拿不准就**留 null**。JSON 里用显式 `null` 而不是省略键:那是一条「查过、确实没有」
- * 的记录,而省略键读起来像是漏了(SearXNG 按定义没有厂商控制台,与 model 表里 ollama/lmstudio
- * 那几家同一个道理)。
- */
 import type { WebSearchProvider } from '../webSearchWireCaps.js';
-/** 目录一行。`id` 是表行主键、`provider` 是 wire 值 —— 两者刻意分开:日后同一个 provider 可以有
- *  多行(比如几个公共 SearXNG 实例各一行),那时 id 才是唯一的那个。 */
 export interface SearchProviderPreset {
     id: string;
     name: string;
     provider: WebSearchProvider;
-    /** brave/tavily 为 true。为 false 时本模块**不会**把 apiKey 写进 env(见 buildWebSearchEnv)。 */
     needsKey: boolean;
-    /** searxng 为 true —— 没有 endpoint 这家根本无从谈起,故缺席时整份配置 fail-closed。 */
     endpointRequired: boolean;
-    /** 端拿去做输入框 placeholder 的**示例**地址。🔴 它不是默认值:本模块绝不自动把它写进 env。 */
     endpointTemplate?: string;
-    /** 去哪拿 key 的官方控制台页(纯链接,离线也能显示)。拿不准的家缺席,绝不编。 */
     consoleUrl?: string;
-    /** 没账号时的注册入口。与 `consoleUrl` 同页的家不重复填(缺席 = 用 consoleUrl 那条)。 */
     signupUrl?: string;
     note?: string;
 }
-/** 搜索 provider 目录(表序即端的展示序)。 */
 export declare const SEARCH_PROVIDER_PRESETS: SearchProviderPreset[];
-/**
- * 数据表自检口(与 `compensationSplitViolations()` 同一个套路:表的不变量做成可执行判据,
- * 由门断言恒空)。上面 `toPreset` 对非法 provider 的行只能**丢掉**(类型化的表里放不下它),
- * 丢掉本身是静默的 —— 这个函数就是那份静默的账。
- */
 export declare function searchPresetTableViolations(): string[];
-/** 按 id 取一行(trim + 大小写不敏感,与 wire 侧 provider 归一同口径)。查不到 ⇒ undefined。 */
 export declare function findSearchPreset(id: string | undefined): SearchProviderPreset | undefined;
-/** 引擎吃的五个 env 键(单一真源:端别再手写字面量)。 */
 export declare const WEB_SEARCH_ENV_KEYS: {
     readonly provider: "WEB_SEARCH_PROVIDER";
     readonly apiKey: "WEB_SEARCH_API_KEY";
@@ -85,21 +22,17 @@ export declare const WEB_SEARCH_ENV_KEYS: {
 };
 export declare const WEB_SEARCH_MAX_RESULTS_MIN = 1;
 export declare const WEB_SEARCH_MAX_RESULTS_MAX = 20;
-/** 引擎侧的默认值,**只供端显示**(「默认 10」)。🔴 绝不由本模块写进 env,理由见文件头纪律 2。 */
 export declare const WEB_SEARCH_ENGINE_DEFAULTS: {
     readonly maxResults: 10;
     readonly timeoutMs: 10000;
 };
-/** 用户在端上做出的选择。全可选 —— 「什么都没选」是合法输入,答案是空 env。 */
 export interface WebSearchChoice {
     presetId?: string;
     apiKey?: string;
-    /** 🔴 语义 = **引擎**可达的地址。http 与 https 都收(内网自建 SearXNG 常是明文口)。 */
     endpoint?: string;
     maxResults?: number;
     timeoutMs?: number;
 }
-/** 配置不可用的**具体**理由(端据此渲提示;「就是没生效」不算交代)。 */
 export type WebSearchChoiceReason = 'no-preset' | 'unknown-preset' | 'missing-api-key' | 'missing-endpoint' | 'invalid-endpoint' | 'max-results-out-of-range' | 'invalid-timeout';
 export type WebSearchChoiceVerdict = {
     ok: true;
@@ -108,19 +41,5 @@ export type WebSearchChoiceVerdict = {
     ok: false;
     reason: WebSearchChoiceReason;
 };
-/**
- * 判定一份选择能不能编译成可用的 env。**纯判定,不产出任何值** —— 端可以在用户还在输入时
- * 反复调它做即时提示,不必担心把半截配置漏给引擎。
- *
- * 🔴 越界的 `maxResults` 判红而不是 clamp:引擎那侧确实会 clamp,但客户端替用户把 50 改成 20
- * 是**替他改了他填的数**却不告诉他。宁可红一下让端说「1..20」。
- */
 export declare function validateWebSearchChoice(choice?: WebSearchChoice): WebSearchChoiceVerdict;
-/**
- * 用户选择 → 引擎 env。**唯一**的编译口(端别自己拼字面量键)。
- *
- * 🔴 三条已在文件头写死的纪律在这里落地:配置不可用 ⇒ `{}`(fail-closed,理由去问
- * `validateWebSearchChoice`);用户没填的可选项不出键(不替引擎钉默认值);任何值都先 trim,
- * 空串一律当没填 —— 返回的对象里**不存在**值为空串的键。
- */
 export declare function buildWebSearchEnv(choice?: WebSearchChoice): Record<string, string>;