@sema-agent/client-core 0.82.7 → 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

@@ -13,9 +13,6 @@ 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';

package/dist/webSearchWireCaps.js

@@ -5,41 +5,6 @@ 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;
-}
-function normMax(v) {
-    const n = typeof v === 'number' ? v : Number(v);
-    return Number.isFinite(n) && n > 0 ? Math.floor(n) : undefined;
-}
-function build(provider, apiKey, endpoint, maxResults) {
-    const max = normMax(maxResults);
-    return {
-        provider,
-        ...(typeof apiKey === 'string' && apiKey ? { apiKey } : {}),
-        ...(typeof endpoint === 'string' && endpoint ? { endpoint } : {}),
-        ...(max ? { maxResults: max } : {}),
-    };
-}
-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]);
-}
-export function webSearchFromSettings(raw) {
-    if (!raw || typeof raw !== 'object')
-        return undefined;
-    const s = raw;
-    const provider = normProvider(s.provider);
-    if (!provider)
-        return undefined;
-    return build(provider, s.apiKey, s.endpoint, s.maxResults);
-}
-export function resolveWebSearch(env = hostEnv(), settingsRaw) {
-    return webSearchFromEnv(env) ?? webSearchFromSettings(settingsRaw);
-}
 const isBlankText = (v) => v.trim() === '';
 function isHierarchicalUrl(raw) {
     try {
@@ -54,12 +19,11 @@ 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 got = raw === undefined || raw === null
-        ? 'it is missing'
-        : typeof raw === 'string'
-            ? 'got a value that is not one of them'
-            : `got ${Array.isArray(raw) ? 'an array' : typeof raw === 'object' ? 'an object' : `a ${typeof raw}`}`;
-    return { ok: false, issue: `must be one of brave | tavily | searxng (${got}); it names where searches go, so an unknown or missing provider is refused rather than replaced` };
+    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)
@@ -76,7 +40,12 @@ function judgeEndpoint(raw) {
         return { ok: false, issue: ENDPOINT_ISSUE };
     if (isBlankText(raw))
         return { ok: true, value: undefined };
-    return isHierarchicalUrl(raw) ? { ok: true, value: raw } : { ok: false, issue: ENDPOINT_ISSUE };
+    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 };
 }
 const COUNT_ISSUE = 'must be a number ≥ 1';
 function judgeCount(raw) {
@@ -97,7 +66,7 @@ function judgeSearxngParams(raw) {
                 continue;
             const eq = seg.indexOf('=');
             if (eq < 0)
-                return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} (entry ${i + 1} has no "=")` };
+                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]);
         }
     }
@@ -106,22 +75,23 @@ function judgeSearxngParams(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} (the value of entry ${i + 1} is not a 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}`})` };
+        return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} — got ${Array.isArray(raw) ? 'an array' : `a ${typeof raw}`}` };
     }
-    const seen = new Set();
+    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 letters, digits, "_", "-", ".")` };
+            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)` };
-        if (seen.has(k))
-            return { ok: false, issue: `${SEARXNG_PARAMS_ISSUE} (entry ${n} repeats an earlier name)` };
-        seen.add(k);
+            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])) };
 }

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 {};