@sema-agent/client-core 0.82.6 → 0.83.0

package/dist/seam.js

@@ -1,3 +1,4 @@
+import { TRANSCRIPT_ID_NAMESPACE, uuidV5 } from './uuidV5.js';
 const CHROME_ARM_TABLE = {
     retry_status: { required: false, duty: '渲/清 spinner 的重试覆盖层' },
     panel_task: { required: true, duty: 'publishEngineAgentPanelEvent(event) 原样转发' },
@@ -63,6 +64,13 @@ const CHROME_ARM_TABLE = {
         duty: 'CC-08(0.71.0):每个压缩边界一条,按**最后一条**取当前值;`usedTokens > compactAtTokens` 是引擎的 shouldCompact 谓词,别重算;`windowTokens` 是 autocompact 窗,' +
             '别渲成模型上下文大小;🔴 `sections[].tokens` 与 `usedTokens` 不同坐标系,**禁相减**、禁拿一段比 `compactAtTokens`;`sections` 整键缺席 = 没装配出段 IR,不是各段为零。',
     },
+    memory_saved: {
+        required: true,
+        duty: '0.83.0 起记忆写入不再是转录行,只发本臂。`notes` 是记忆**笔记原文、不是路径**(别拼链接 / 判文件存在);' +
+            '要保留「Saved N memories」那一行的宿主把本臂还原成一条转录行:行 uuid 用 `id`(由这次写入的 wire 稳定键派生、重投同值,按它幂等;与 0.82.x 旧行 uuid 不相等),N = `notes.length`,时间戳在接收口取;' +
+            '落成 CC 形行时不许再造 `writtenPaths` / `isMeta` 这类 CC 在该臂上不声明的键;每次写入一条事件、本包不合并;' +
+            '没收到本臂不等于没写记忆(回执不成形时不发,工具卡照常在);laneProof 为 subagent = 子代写的,别渲成主会话的。',
+    },
     compaction_outcome: {
         required: false,
         duty: 'CC-89(0.75.0):一次压缩的非 compacted 结局(作废 / 失败等),给用户一条可见提示。`outcome` / `trigger` 是引擎开集原词,按成员渲染必带 default 臂、认不得照原词显示;' +
@@ -139,12 +147,15 @@ const CHROME_ARM_TABLE = {
     },
 };
 export const CHROME_ARMS = Object.entries(CHROME_ARM_TABLE).map(([kind, d]) => ({ kind, required: d.required, duty: d.duty }));
-export function deriveTranscriptId(frame, ctx) {
-    if (typeof frame.id === 'string' && frame.id.length > 0)
-        return `wid_${frame.id}`;
-    if (typeof frame.seq === 'number')
-        return `wseq_${frame.seq}`;
-    if (typeof frame.toolCallId === 'string' && frame.toolCallId.length > 0)
-        return `wtc_${frame.toolCallId}`;
+export function deriveTranscriptId(frame, ctx, suffix) {
+    if (typeof frame.id === 'string' && frame.id.length > 0) {
+        return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wid_${frame.id}#${suffix}` : `wid_${frame.id}`);
+    }
+    if (typeof frame.seq === 'number') {
+        return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wseq#${suffix}_${frame.seq}` : `wseq_${frame.seq}`);
+    }
+    if (typeof frame.toolCallId === 'string' && frame.toolCallId.length > 0) {
+        return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wtc#${suffix}_${frame.toolCallId}` : `wtc_${frame.toolCallId}`);
+    }
     return ctx.uuid();
 }

package/dist/systemReminderTag.d.ts

@@ -1,3 +1,2 @@
 export declare function unwrapSystemReminder(text: string): string;
 export declare function stripSystemReminderBlocks(text: string): string;
-export declare function startsWithSystemReminderOpenTag(text: string): boolean;

package/dist/systemReminderTag.js

@@ -7,6 +7,3 @@ export function unwrapSystemReminder(text) {
 export function stripSystemReminderBlocks(text) {
     return text.replace(new RegExp(`${OPEN_TAG_SOURCE}[\\s\\S]*?<\\/system-reminder>`, 'g'), '');
 }
-export function startsWithSystemReminderOpenTag(text) {
-    return new RegExp(`^\\s*${OPEN_TAG_SOURCE}`).test(text);
-}

package/dist/toolResult.js

@@ -47,6 +47,7 @@ export const STRUCTURED_DETAIL_TYPES = new Set([
     'read_path_denied',
     'list-agents',
     'artifact',
+    'read-inbox',
 ]);
 export function structuredDetailType(structured) {
     if (typeof structured !== 'object' || structured === null)

package/dist/uuidV5.d.ts

@@ -0,0 +1,3 @@
+export declare const TRANSCRIPT_ID_NAMESPACE = "5935225a-0f39-4c72-b409-4893196112ab";
+export declare function utf8Encode(s: string): Uint8Array;
+export declare function uuidV5(namespace: string, name: string): string;

package/dist/uuidV5.js

@@ -0,0 +1,178 @@
+export const TRANSCRIPT_ID_NAMESPACE = '5935225a-0f39-4c72-b409-4893196112ab';
+const HEX = '0123456789abcdef';
+export function utf8Encode(s) {
+    let n = 0;
+    for (let i = 0; i < s.length; i++) {
+        const c = s.charCodeAt(i);
+        if (c < 0x80)
+            n += 1;
+        else if (c < 0x800)
+            n += 2;
+        else if (c >= 0xd800 && c <= 0xdbff && i + 1 < s.length) {
+            const d = s.charCodeAt(i + 1);
+            if (d >= 0xdc00 && d <= 0xdfff) {
+                n += 4;
+                i++;
+            }
+            else
+                n += 3;
+        }
+        else
+            n += 3;
+    }
+    const out = new Uint8Array(n);
+    let p = 0;
+    for (let i = 0; i < s.length; i++) {
+        let c = s.charCodeAt(i);
+        if (c >= 0xd800 && c <= 0xdfff) {
+            const d = c <= 0xdbff && i + 1 < s.length ? s.charCodeAt(i + 1) : 0;
+            if (c <= 0xdbff && d >= 0xdc00 && d <= 0xdfff) {
+                c = 0x10000 + ((c - 0xd800) << 10) + (d - 0xdc00);
+                i++;
+                out[p++] = 0xf0 | (c >>> 18);
+                out[p++] = 0x80 | ((c >>> 12) & 0x3f);
+                out[p++] = 0x80 | ((c >>> 6) & 0x3f);
+                out[p++] = 0x80 | (c & 0x3f);
+                continue;
+            }
+            c = 0xfffd;
+        }
+        if (c < 0x80) {
+            out[p++] = c;
+        }
+        else if (c < 0x800) {
+            out[p++] = 0xc0 | (c >>> 6);
+            out[p++] = 0x80 | (c & 0x3f);
+        }
+        else {
+            out[p++] = 0xe0 | (c >>> 12);
+            out[p++] = 0x80 | ((c >>> 6) & 0x3f);
+            out[p++] = 0x80 | (c & 0x3f);
+        }
+    }
+    return out;
+}
+function sha1(msg) {
+    const len = msg.length;
+    const blocks = ((len + 8) >>> 6) + 1;
+    const buf = new Uint8Array(blocks * 64);
+    buf.set(msg);
+    buf[len] = 0x80;
+    const bitsHi = Math.floor(len / 0x20000000);
+    const bitsLo = (len << 3) >>> 0;
+    const end = buf.length;
+    buf[end - 8] = (bitsHi >>> 24) & 0xff;
+    buf[end - 7] = (bitsHi >>> 16) & 0xff;
+    buf[end - 6] = (bitsHi >>> 8) & 0xff;
+    buf[end - 5] = bitsHi & 0xff;
+    buf[end - 4] = (bitsLo >>> 24) & 0xff;
+    buf[end - 3] = (bitsLo >>> 16) & 0xff;
+    buf[end - 2] = (bitsLo >>> 8) & 0xff;
+    buf[end - 1] = bitsLo & 0xff;
+    let h0 = 0x67452301;
+    let h1 = 0xefcdab89;
+    let h2 = 0x98badcfe;
+    let h3 = 0x10325476;
+    let h4 = 0xc3d2e1f0;
+    const w = new Int32Array(80);
+    for (let off = 0; off < end; off += 64) {
+        for (let t = 0; t < 16; t++) {
+            const q = off + t * 4;
+            w[t] = ((buf[q] ?? 0) << 24) | ((buf[q + 1] ?? 0) << 16) | ((buf[q + 2] ?? 0) << 8) | (buf[q + 3] ?? 0);
+        }
+        for (let t = 16; t < 80; t++) {
+            const x = (w[t - 3] ?? 0) ^ (w[t - 8] ?? 0) ^ (w[t - 14] ?? 0) ^ (w[t - 16] ?? 0);
+            w[t] = (x << 1) | (x >>> 31);
+        }
+        let a = h0;
+        let b = h1;
+        let c = h2;
+        let d = h3;
+        let e = h4;
+        for (let t = 0; t < 80; t++) {
+            let f;
+            let k;
+            if (t < 20) {
+                f = (b & c) | (~b & d);
+                k = 0x5a827999;
+            }
+            else if (t < 40) {
+                f = b ^ c ^ d;
+                k = 0x6ed9eba1;
+            }
+            else if (t < 60) {
+                f = (b & c) | (b & d) | (c & d);
+                k = 0x8f1bbcdc;
+            }
+            else {
+                f = b ^ c ^ d;
+                k = 0xca62c1d6;
+            }
+            const tmp = (((a << 5) | (a >>> 27)) + f + e + k + (w[t] ?? 0)) | 0;
+            e = d;
+            d = c;
+            c = (b << 30) | (b >>> 2);
+            b = a;
+            a = tmp;
+        }
+        h0 = (h0 + a) | 0;
+        h1 = (h1 + b) | 0;
+        h2 = (h2 + c) | 0;
+        h3 = (h3 + d) | 0;
+        h4 = (h4 + e) | 0;
+    }
+    const out = new Uint8Array(20);
+    const hs = [h0, h1, h2, h3, h4];
+    for (let i = 0; i < 5; i++) {
+        const h = hs[i] ?? 0;
+        out[i * 4] = (h >>> 24) & 0xff;
+        out[i * 4 + 1] = (h >>> 16) & 0xff;
+        out[i * 4 + 2] = (h >>> 8) & 0xff;
+        out[i * 4 + 3] = h & 0xff;
+    }
+    return out;
+}
+function hexVal(ch) {
+    if (ch >= 0x30 && ch <= 0x39)
+        return ch - 0x30;
+    if (ch >= 0x61 && ch <= 0x66)
+        return ch - 0x61 + 10;
+    if (ch >= 0x41 && ch <= 0x46)
+        return ch - 0x41 + 10;
+    return -1;
+}
+export function uuidV5(namespace, name) {
+    if (namespace.length !== 36)
+        throw new TypeError('uuidV5: namespace must be a 36-character UUID string');
+    const ns = new Uint8Array(16);
+    let j = 0;
+    for (let i = 0; i < 36; i++) {
+        const ch = namespace.charCodeAt(i);
+        if (i === 8 || i === 13 || i === 18 || i === 23) {
+            if (ch !== 0x2d)
+                throw new TypeError('uuidV5: namespace must be a 36-character UUID string');
+            continue;
+        }
+        const hi = hexVal(ch);
+        const lo = hexVal(namespace.charCodeAt(i + 1));
+        if (hi < 0 || lo < 0)
+            throw new TypeError('uuidV5: namespace must be a 36-character UUID string');
+        ns[j++] = (hi << 4) | lo;
+        i++;
+    }
+    const nameBytes = utf8Encode(name);
+    const input = new Uint8Array(16 + nameBytes.length);
+    input.set(ns);
+    input.set(nameBytes, 16);
+    const h = sha1(input);
+    h[6] = ((h[6] ?? 0) & 0x0f) | 0x50;
+    h[8] = ((h[8] ?? 0) & 0x3f) | 0x80;
+    let s = '';
+    for (let i = 0; i < 16; i++) {
+        if (i === 4 || i === 6 || i === 8 || i === 10)
+            s += '-';
+        const b = h[i] ?? 0;
+        s += HEX.charAt(b >>> 4) + HEX.charAt(b & 0x0f);
+    }
+    return s;
+}

package/dist/webSearchWireCaps.d.ts

@@ -5,6 +5,7 @@ export interface WebSearchSettings {
     apiKey?: string;
     endpoint?: string;
     maxResults?: number;
+    searxngParams?: Record<string, string>;
 }
 export declare const WEBSEARCH_ENV: {
     readonly provider: "SEMA_WEBSEARCH_PROVIDER";
@@ -12,6 +13,22 @@ export declare const WEBSEARCH_ENV: {
     readonly apiKey: "SEMA_WEBSEARCH_API_KEY";
     readonly maxResults: "SEMA_WEBSEARCH_MAX_RESULTS";
 };
-export declare function webSearchFromEnv(env?: EnvLike): WebSearchSettings | undefined;
-export declare function webSearchFromSettings(raw: unknown): WebSearchSettings | undefined;
-export declare function resolveWebSearch(env?: EnvLike, settingsRaw?: unknown): WebSearchSettings | undefined;
+export type WebSearchSettingsField = 'section' | 'provider' | 'apiKey' | 'endpoint' | 'searxngParams' | 'maxResults';
+export type WebSearchSettingsVerdict = {
+    kind: 'absent';
+} | {
+    kind: 'honored';
+    source: 'env' | 'settings';
+    settings: WebSearchSettings;
+} | {
+    kind: 'malformed';
+    source: 'env' | 'settings';
+    field: WebSearchSettingsField;
+    issue: string;
+};
+export type WebSearchApiKeyFor = (provider: WebSearchProvider, section: Readonly<Record<string, unknown>>) => string | undefined;
+export declare function judgeWebSearchSettings(raw: unknown, apiKeyFor?: WebSearchApiKeyFor): WebSearchSettingsVerdict;
+export declare function webSearchVerdictFromEnv(env?: EnvLike): WebSearchSettingsVerdict;
+export declare function resolveWebSearchVerdict(env?: EnvLike, settingsRaw?: unknown, apiKeyFor?: WebSearchApiKeyFor): WebSearchSettingsVerdict;
+export declare function webSearchVerdictMessage(verdict: WebSearchSettingsVerdict, context?: 'submit' | 'check'): string | undefined;
+export declare function webSearchEndpointForDisplay(raw: string): string | undefined;

package/dist/webSearchWireCaps.js

@@ -5,38 +5,206 @@ export const WEBSEARCH_ENV = {
     apiKey: 'SEMA_WEBSEARCH_API_KEY',
     maxResults: 'SEMA_WEBSEARCH_MAX_RESULTS',
 };
-function normProvider(v) {
-    const p = typeof v === 'string' ? v.trim().toLowerCase() : '';
-    return p === 'brave' || p === 'tavily' || p === 'searxng' ? p : undefined;
+const isBlankText = (v) => v.trim() === '';
+function isHierarchicalUrl(raw) {
+    try {
+        const u = new URL(raw);
+        return u.href.startsWith(u.protocol + '//');
+    }
+    catch {
+        return false;
+    }
 }
-function normMax(v) {
-    const n = typeof v === 'number' ? v : Number(v);
-    return Number.isFinite(n) && n > 0 ? Math.floor(n) : undefined;
+function judgeProvider(raw) {
+    const word = typeof raw === 'string' ? raw.trim().toLowerCase() : undefined;
+    if (word === 'brave' || word === 'tavily' || word === 'searxng')
+        return { ok: true, value: word };
+    const shape = raw === undefined || raw === null ? 'it is missing' : typeof raw === 'string' ? 'it is not one of them' : 'it is not a string';
+    return {
+        ok: false,
+        issue: `must name one of brave | tavily | searxng (${shape}) — it names where this request's searches go, so an unknown or missing provider is refused rather than replaced by this deployment's own backend`,
+    };
+}
+function judgeText(raw) {
+    if (raw === undefined || raw === null)
+        return { ok: true, value: undefined };
+    if (typeof raw !== 'string')
+        return { ok: false, issue: 'must be a string' };
+    return { ok: true, value: isBlankText(raw) ? undefined : raw };
+}
+const ENDPOINT_ISSUE = 'must be an absolute URL with a scheme and a host, such as https://search.example.com (a bare host or host:port is not one)';
+function judgeEndpoint(raw) {
+    if (raw === undefined || raw === null)
+        return { ok: true, value: undefined };
+    if (typeof raw !== 'string')
+        return { ok: false, issue: ENDPOINT_ISSUE };
+    if (isBlankText(raw))
+        return { ok: true, value: undefined };
+    if (!isHierarchicalUrl(raw))
+        return { ok: false, issue: ENDPOINT_ISSUE };
+    const u = new URL(raw);
+    return u.username !== '' || u.password !== ''
+        ? { ok: false, issue: 'must not carry userinfo (user or user:password before the host)' }
+        : { ok: true, value: raw };
 }
-function build(provider, apiKey, endpoint, maxResults) {
-    const max = normMax(maxResults);
+const COUNT_ISSUE = 'must be a number ≥ 1';
+function judgeCount(raw) {
+    if (raw === undefined || raw === null)
+        return { ok: true, value: undefined };
+    return typeof raw === 'number' && Number.isFinite(raw) && raw >= 1 ? { ok: true, value: Math.floor(raw) } : { ok: false, issue: COUNT_ISSUE };
+}
+const SEARXNG_PARAMS_ISSUE = 'must be an object of parameter name → non-empty string, or a "name=value;name=value" string';
+function judgeSearxngParams(raw) {
+    if (raw === undefined || raw === null)
+        return { ok: true, value: undefined };
+    const pairs = [];
+    if (typeof raw === 'string') {
+        const segments = raw.split(';');
+        for (let i = 0; i < segments.length; i++) {
+            const seg = segments[i];
+            if (isBlankText(seg))
+                continue;
+            const eq = seg.indexOf('=');
+            if (eq < 0)
+                return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} — entry #${i + 1} has no "="` };
+            pairs.push([seg.slice(0, eq).trim(), seg.slice(eq + 1).trim(), i + 1]);
+        }
+    }
+    else if (typeof raw === 'object' && !Array.isArray(raw)) {
+        const entries = Object.entries(raw);
+        for (let i = 0; i < entries.length; i++) {
+            const [k, v] = entries[i];
+            if (typeof v !== 'string')
+                return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} — entry #${i + 1} has a value that is not a string` };
+            pairs.push([k, v.trim(), i + 1]);
+        }
+    }
+    else {
+        return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} — got ${Array.isArray(raw) ? 'an array' : `a ${typeof raw}`}` };
+    }
+    const firstEntryOf = new Map();
+    for (const [k, v, n] of pairs) {
+        if (!/^[A-Za-z0-9_.-]+$/.test(k))
+            return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} — entry #${n} has a name that is not a parameter name (letters, digits, "_", "-", ".")` };
+        if (v === '')
+            return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} — entry #${n} has an empty value` };
+        const first = firstEntryOf.get(k);
+        if (first !== undefined)
+            return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} — entry #${n} repeats the name of entry #${first}` };
+        firstEntryOf.set(k, n);
+    }
+    return { ok: true, value: pairs.length === 0 ? undefined : Object.fromEntries(pairs.map(([k, v]) => [k, v])) };
+}
+function judgeSection(raw, source, apiKeyFor) {
+    if (raw === undefined || raw === null)
+        return { kind: 'absent' };
+    if (typeof raw !== 'object' || Array.isArray(raw)) {
+        return { kind: 'malformed', source, field: 'section', issue: 'must be an object { provider, apiKey?, endpoint?, searxngParams?, maxResults? }' };
+    }
+    const s = raw;
+    const provider = judgeProvider(s.provider);
+    if (!provider.ok)
+        return { kind: 'malformed', source, field: 'provider', issue: provider.issue };
+    let injected;
+    if (apiKeyFor !== undefined) {
+        try {
+            injected = apiKeyFor(provider.value, s);
+        }
+        catch {
+            injected = undefined;
+        }
+    }
+    const apiKey = typeof injected === 'string' && !isBlankText(injected) ? { ok: true, value: injected } : judgeText(s.apiKey);
+    if (!apiKey.ok)
+        return { kind: 'malformed', source, field: 'apiKey', issue: apiKey.issue };
+    const endpoint = judgeEndpoint(s.endpoint);
+    if (!endpoint.ok)
+        return { kind: 'malformed', source, field: 'endpoint', issue: endpoint.issue };
+    const searxngParams = judgeSearxngParams(s.searxngParams);
+    if (!searxngParams.ok)
+        return { kind: 'malformed', source, field: 'searxngParams', issue: searxngParams.issue };
+    const maxResults = judgeCount(s.maxResults);
+    if (!maxResults.ok)
+        return { kind: 'malformed', source, field: 'maxResults', issue: maxResults.issue };
     return {
-        provider,
-        ...(typeof apiKey === 'string' && apiKey ? { apiKey } : {}),
-        ...(typeof endpoint === 'string' && endpoint ? { endpoint } : {}),
-        ...(max ? { maxResults: max } : {}),
+        kind: 'honored',
+        source,
+        settings: {
+            provider: provider.value,
+            ...(apiKey.value !== undefined ? { apiKey: apiKey.value } : {}),
+            ...(endpoint.value !== undefined ? { endpoint: endpoint.value } : {}),
+            ...(searxngParams.value !== undefined ? { searxngParams: searxngParams.value } : {}),
+            ...(maxResults.value !== undefined ? { maxResults: maxResults.value } : {}),
+        },
     };
 }
-export function webSearchFromEnv(env = hostEnv()) {
-    const provider = normProvider(env[WEBSEARCH_ENV.provider]);
-    if (!provider)
+export function judgeWebSearchSettings(raw, apiKeyFor) {
+    try {
+        return judgeSection(raw, 'settings', apiKeyFor);
+    }
+    catch {
+        return { kind: 'malformed', source: 'settings', field: 'section', issue: 'could not be read' };
+    }
+}
+export function webSearchVerdictFromEnv(env = hostEnv()) {
+    try {
+        const read = (k) => {
+            const v = env[k];
+            return typeof v === 'string' && !isBlankText(v) ? v : undefined;
+        };
+        const provider = read(WEBSEARCH_ENV.provider);
+        const apiKey = read(WEBSEARCH_ENV.apiKey);
+        const endpoint = read(WEBSEARCH_ENV.endpoint);
+        const maxRaw = read(WEBSEARCH_ENV.maxResults);
+        if (provider === undefined && apiKey === undefined && endpoint === undefined && maxRaw === undefined)
+            return { kind: 'absent' };
+        return judgeSection({
+            ...(provider !== undefined ? { provider } : {}),
+            ...(apiKey !== undefined ? { apiKey } : {}),
+            ...(endpoint !== undefined ? { endpoint } : {}),
+            ...(maxRaw !== undefined ? { maxResults: Number(maxRaw.trim()) } : {}),
+        }, 'env');
+    }
+    catch {
+        return { kind: 'malformed', source: 'env', field: 'section', issue: 'could not be read' };
+    }
+}
+export function resolveWebSearchVerdict(env = hostEnv(), settingsRaw, apiKeyFor) {
+    const fromEnv = webSearchVerdictFromEnv(env);
+    return fromEnv.kind === 'absent' ? judgeWebSearchSettings(settingsRaw, apiKeyFor) : fromEnv;
+}
+function envNameOfField(field) {
+    switch (field) {
+        case 'provider':
+            return WEBSEARCH_ENV.provider;
+        case 'apiKey':
+            return WEBSEARCH_ENV.apiKey;
+        case 'endpoint':
+            return WEBSEARCH_ENV.endpoint;
+        case 'maxResults':
+            return WEBSEARCH_ENV.maxResults;
+        case 'section':
+        case 'searxngParams':
+            return 'the SEMA_WEBSEARCH_* variables';
+    }
+}
+export function webSearchVerdictMessage(verdict, context = 'submit') {
+    if (verdict.kind !== 'malformed')
         return undefined;
-    return build(provider, env[WEBSEARCH_ENV.apiKey], env[WEBSEARCH_ENV.endpoint], env[WEBSEARCH_ENV.maxResults]);
+    const where = verdict.source === 'env' ? envNameOfField(verdict.field) : verdict.field === 'section' ? 'the webSearch section in settings' : `webSearch.${verdict.field} in settings`;
+    const fix = verdict.source === 'env' ? 'fix it or unset the SEMA_WEBSEARCH_* variables' : 'fix it or remove the webSearch section';
+    return context === 'submit'
+        ? `Web search is misconfigured: ${where} ${verdict.issue}. The request was not sent — ${fix}.`
+        : `Web search is misconfigured: ${where} ${verdict.issue}. Requests will be refused until you ${fix}.`;
 }
-export function webSearchFromSettings(raw) {
-    if (!raw || typeof raw !== 'object')
+export function webSearchEndpointForDisplay(raw) {
+    if (typeof raw !== 'string' || !isHierarchicalUrl(raw))
         return undefined;
-    const s = raw;
-    const provider = normProvider(s.provider);
-    if (!provider)
+    try {
+        const u = new URL(raw);
+        return u.protocol + '//' + u.host;
+    }
+    catch {
         return undefined;
-    return build(provider, s.apiKey, s.endpoint, s.maxResults);
-}
-export function resolveWebSearch(env = hostEnv(), settingsRaw) {
-    return webSearchFromEnv(env) ?? webSearchFromSettings(settingsRaw);
+    }
 }

package/dist/wireFailureShape.d.ts

@@ -1,4 +1,4 @@
-export interface WireFailureShape {
+interface WireFailureShape {
     status?: number;
     errorCode?: string;
     retryAfterSec?: number;
@@ -9,3 +9,4 @@ export declare function readErrorNumber(o: object, key: string): number | undefi
 export declare function readErrorString(o: object, key: string): string | undefined;
 export declare function readErrorStringList(o: object, key: string): readonly string[] | undefined;
 export declare function wireFailureShapeOf(e: unknown): WireFailureShape;
+export {};