@sema-agent/client-core 0.108.0 → 0.110.0

package/dist/request/taskRequest.js

@@ -8,9 +8,9 @@ import { PROJECT_MEMORY_DISABLED } from '../projectMemory.js';
 import { frameFamiliesJudgementOf } from '../approvalFrameFamilies.js';
 import { outputStyleSeatAdmitted } from '../outputStyleSeatCapability.js';
 import { refuseBadApprovalReach } from '../approvalReachWire.js';
-import { HOST_SUPPLIED_KEYS, UNWIRED_HOST_TURN_SETTINGS, buildHostTurnSettings, hostIntakeSnapshotOf, hostFileHistoryRestoreNotice, hostProjectionNotice, hostTurnSettingsOf, intersectHostHooks, rethrowHostResolvedDeferred, hostSettingsRefusedError, } from '../hostTurnSettings.js';
+import { HOST_SUPPLIED_KEYS, UNWIRED_HOST_TURN_SETTINGS, buildHostTurnSettings, hostIntakeSnapshotOf, hostFileHistoryRestoreNotice, hostProjectionNotice, hostStyleNotAppliedNotice, hostTurnSettingsOf, hookEnvNamesOf, intersectHostHooks, rethrowHostResolvedDeferred, hostSettingsRefusedError, } from '../hostTurnSettings.js';
 import { SUBMISSION_ORIGINS, SUBMISSION_SURFACES, SUBMISSION_TOOLS, submissionAxesOf, } from './submissionIdentity.js';
-import { withAssemblyRefusal } from '../wireFailureShape.js';
+import { slotReadOf, withAssemblyRefusal } from '../wireFailureShape.js';
 import { isPlainRecord, materializeJsonFaithful, shapeTag } from '../jsonFaithful.js';
 export const REQUEST_FIELD_MATRIX = [
     { field: 'objective', lanes: ['interactive', 'print', 'utility'], live: false, why: '本 turn 的真实输入,每条车道都必需', whyUtilityLane: '恒座:三条车道都必须带上本次提交的模型面输入' },
@@ -29,6 +29,7 @@ export const REQUEST_FIELD_MATRIX = [
     { field: 'mcpServers', lanes: ['interactive', 'print'], live: true, why: '本地 .mcp.json 投影;service 单用户门决定是否兑现', whyUtilityLane: '无座:MCP 服务挂的是工具,与零工具面矛盾' },
     { field: 'settings.webSearch', lanes: ['interactive', 'print'], live: true, why: 'SEMA_WEBSEARCH_* / settings.json;per-request 配置赢过部署 env', whyUtilityLane: '无座:联网检索是一只工具,与零工具面矛盾' },
     { field: 'settings.hooks', lanes: ['interactive', 'print'], live: true, why: '[495]① 用户 settings 文件 hooks 逐字上 wire', whyUtilityLane: '无座:hook 挂在工具门上(零工具面没有门),而且 side-channel 是壳自己的提交,不该继承用户那份 hook 表' },
+    { field: 'settings.env', lanes: ['interactive', 'print'], live: true, why: '交引擎执行的 http hook 头 `$NAME` 插值的那一层环境(服务端 `settings.env`:引擎 hook 环境 = 十二名基础名单 + 本键;同一份也进引擎命令 hook 与单用户宿主车道的会话 shell 环境 —— 服务端的设计)。两条用户车道都把 hooks 交给引擎执行 ⇒ 都有座,与 settings.hooks 同座。值只由宿主自供项入口按 hooks 那一行算出:名集 = 这一发请求体 hooks 里引擎点亮的事件下 http 条目 allowedEnvVars 之并 ∩ 宿主环境在场,值 = 环境原值,名集空 ⇒ 键缺席;不按凭据名预筛(凭据判官只在服务端:400 request.env_credential_refused)', whyUtilityLane: '无座:与 settings.hooks 同理由 —— side-channel 不带用户的 hook 表,就没有要插值的 http 头;带上它只会把宿主环境里的值交给一条零工具面的提交' },
     { field: 'settings.approvalFrameFamilies', lanes: ['interactive', 'print'], live: true, why: '这条运行的客户端渲得了哪些审批开卡帧族的**逐运行声明**(服务端提交体 `settings.approvalFrameFamilies`:词数组,值族闭集 tool_approval / approval_request;一条运行只在声明含服务端呈的那一族时才开审批卡,不含 ⇒ 问当场交无人值守政策口、不出卡)。两条用户车道都有审批腿(交互面出卡答人;`-p` 面交宿主的审批口),都得声明;🔴 只在能力读数 confirmed(受理位 `taskSettings.approvalFrameFamilies` 恒真 ∧ 值族位合格)时由装配口自己铸,老服务端(受理位缺席)对表外 settings 子键整条 400', whyUtilityLane: '无座:side-channel 强制零工具面(`excludeAllTools`),没有门控调用、不会问审批 ⇒ 声明没有对象;带上它只会在不认识这一键的老服务端上给这条提交多一种 400' },
     { field: 'settings.<resolved>', lanes: ['interactive', 'print'], live: true, why: 'settings resolver 的 effective 快照(hooks/env/model + 已解析权限投影)。两条车道同源:交互面 replEntry / print 面 printModeEngine 各跑一遍同一个 resolver,产物经同一个 buildWireSettingsStamp 投影。开放集(子键不可枚举)⇒ unregisteredRequestKeys 放行本车道 settings 的**表外**子键,但表内异车道子键仍点名', whyUtilityLane: '无座:这一位是**开放集 spread**(子键原样即 wire 键),摊开的是用户 settings 的已解析面(权限 / env / 模型)。side-channel 是壳自己的提交:摊上去既无用(零工具面没有工具门求值权限)又把用户的配置面带进了一条他没参与的提交。🔴 无座 ⇒ 本车道整只快照不产。🔴 **本行无座的前提由构造期校验兜住**:剥掉的是用户显式的 deny / ask,所以 `refuseUtilityWithoutToolUnload` 强制这条车道必须带字面 `excludeAllTools: true` —— 否则产出会是一条「既没卸工具、又没带用户 deny」的请求(比无人值守车道同一份输入更宽)' },
     { field: 'repo', lanes: ['interactive', 'print'], live: true, why: 'scan/code-review 场景的仓库坐标(passthrough;server 是权威校验方,本层不铸第二判官)', whyUtilityLane: '无座:场景键;side-channel 不走场景' },
@@ -217,6 +218,7 @@ const SETTINGS_KEY_ROUTES = {
     webSearch: row('settings.webSearch'),
     ultracode: row('settings.ultracode'),
     hooks: row('settings.hooks'),
+    env: row('settings.env'),
     approvalFrameFamilies: row('settings.approvalFrameFamilies'),
     outputStyle: { via: 'always' },
 };
@@ -520,27 +522,59 @@ export function refilterHostSettings(request, fresh, lane) {
     const base = tight.request;
     const tightened = tight.tightened;
     const settings = base.settings;
-    if (!isPlainRecord(settings) || !Object.hasOwn(settings, 'hooks'))
+    if (!isPlainRecord(settings))
         return Object.freeze({ kind: 'send', request: base, hooksDropped: 0, tightened });
-    const disposition = intake.dispositions['settings.hooks'];
-    if (disposition === 'unwired')
-        return Object.freeze({ kind: 'send', request: base, hooksDropped: 0, tightened });
-    const now = intake.carried.hooks;
-    const sentHooks = settings.hooks;
-    if (!isPlainRecord(sentHooks))
-        return Object.freeze({ kind: 'refuse', notice: refuseNotice() });
-    const cut = intersectHostHooks(sentHooks, now);
-    if (!cut.judged)
-        return Object.freeze({ kind: 'refuse', notice: refuseNotice() });
-    if (cut.dropped === 0)
+    const unjudged = () => Object.freeze({ kind: 'refuse', notice: refuseNotice() });
+    let nextSettings = settings;
+    let hooksDropped = 0;
+    let finalHooks;
+    if (Object.hasOwn(settings, 'hooks')) {
+        const sentHooks = settings.hooks;
+        if (intake.dispositions['settings.hooks'] === 'unwired')
+            finalHooks = sentHooks;
+        else {
+            const now = intake.carried.hooks;
+            if (!isPlainRecord(sentHooks))
+                return unjudged();
+            const cut = intersectHostHooks(sentHooks, now);
+            if (!cut.judged)
+                return unjudged();
+            finalHooks = cut.hooks;
+            if (cut.dropped > 0) {
+                const { hooks: _sentHooks, ...restSettings } = settings;
+                void _sentHooks;
+                nextSettings = cut.hooks === undefined ? restSettings : { ...restSettings, hooks: cut.hooks };
+                hooksDropped = cut.dropped;
+            }
+        }
+    }
+    if (Object.hasOwn(nextSettings, 'env')) {
+        const sentEnv = nextSettings.env;
+        if (!isPlainRecord(sentEnv))
+            return unjudged();
+        let names;
+        try {
+            names = hookEnvNamesOf(finalHooks);
+        }
+        catch {
+            return unjudged();
+        }
+        const nowEnv = intake.carried.env;
+        const envUnwired = intake.dispositions['settings.env'] === 'unwired';
+        const sentKeys = Object.keys(sentEnv);
+        const kept = sentKeys.filter((k) => names.includes(k) && (envUnwired || (nowEnv !== undefined && Object.hasOwn(nowEnv, k))));
+        if (kept.length !== sentKeys.length) {
+            const { env: _sentEnv, ...restSettings } = nextSettings;
+            void _sentEnv;
+            nextSettings = kept.length === 0 ? restSettings : { ...restSettings, env: Object.fromEntries(kept.map((k) => [k, sentEnv[k]])) };
+        }
+    }
+    if (nextSettings === settings)
         return Object.freeze({ kind: 'send', request: base, hooksDropped: 0, tightened });
-    const { hooks: _sentHooks, ...restSettings } = settings;
-    void _sentHooks;
-    const nextSettings = cut.hooks === undefined ? restSettings : { ...restSettings, hooks: cut.hooks };
     const { settings: _sentSettings, ...restRequest } = base;
     void _sentSettings;
     const next = Object.keys(nextSettings).length > 0 ? { ...restRequest, settings: nextSettings } : restRequest;
-    return Object.freeze({ kind: 'send', request: next, hooksDropped: cut.dropped, tightened });
+    return Object.freeze({ kind: 'send', request: next, hooksDropped, tightened });
 }
 export const MEMORY_CAPTURE_OFF = 'off';
 export function memoryCaptureDeclarationField(declared) {
@@ -924,6 +958,7 @@ export function assembleTaskRequest(input, laneOrIdentity) {
         hooks: intake.carried.hooks,
         outputStyle: intake.carried.outputStyle,
         approvalFrameFamilies: approvalFamilies,
+        env: intake.carried.env,
     };
     refuseBadMemoryCapture(memoryCaptureIn);
     refuseBadMaxCostUsd(maxCostUsdIn);
@@ -1080,6 +1115,7 @@ export function assembleTaskRequest(input, laneOrIdentity) {
         ...(onSetting('webSearch') ? { webSearch: s.webSearch } : {}),
         ...(onSetting('ultracode') ? { ultracode: s.ultracode } : {}),
         ...(onSetting('hooks') ? { hooks: s.hooks } : {}),
+        ...(onSetting('env') ? { env: { ...s.env } } : {}),
         ...(s.outputStyle !== undefined ? { outputStyle: s.outputStyle } : {}),
         ...(onSetting('approvalFrameFamilies') ? { approvalFrameFamilies: [...(s.approvalFrameFamilies ?? [])] } : {}),
     };
@@ -1228,6 +1264,74 @@ export function thinkingTurnProjection(input) {
     return projectThinkingCore({ lane, latch, strength, floor, ultracodeStamped: seated && inPlay('settings.ultracode', ultracode) && ultracode === true });
 }
 export function applyLiveRequestDefaults(req, host) {
+    return liveRequestDefaultsOf(req, host).request;
+}
+export function applyLiveRequestDefaultsWithNotices(req, host) {
+    return liveRequestDefaultsOf(req, host);
+}
+const SELF_KNOWLEDGE_JOIN = '\n\n';
+const OUTPUT_STYLE_MAX_CHARS = 16384;
+function selfKnowledgeSeatOf(block, readBody) {
+    if (typeof block !== 'string')
+        return { kind: 'set', value: block };
+    let body;
+    const read = readBody();
+    if (read !== undefined) {
+        if (read.presence === 'unreadable')
+            return { kind: 'set', value: block, notice: hostStyleNotAppliedNotice('unreadable', OUTPUT_STYLE_MAX_CHARS) };
+        if (read.presence === 'present' && read.value !== undefined && read.value !== null) {
+            if (typeof read.value !== 'string')
+                return { kind: 'set', value: block, notice: hostStyleNotAppliedNotice('unreadable', OUTPUT_STYLE_MAX_CHARS) };
+            if (read.value.trim() !== '')
+                body = read.value;
+        }
+    }
+    if (body === undefined)
+        return { kind: 'set', value: block };
+    let merged;
+    let separable = false;
+    if (block.trim() === '' || body === block || body.startsWith(block + SELF_KNOWLEDGE_JOIN)) {
+        merged = body;
+    }
+    else if (block.endsWith(SELF_KNOWLEDGE_JOIN + body)) {
+        merged = block;
+    }
+    else {
+        merged = block + SELF_KNOWLEDGE_JOIN + body;
+        separable = true;
+    }
+    if (merged.length <= OUTPUT_STYLE_MAX_CHARS)
+        return { kind: 'set', value: merged };
+    const notice = hostStyleNotAppliedNotice('oversize', OUTPUT_STYLE_MAX_CHARS);
+    return separable && block.length <= OUTPUT_STYLE_MAX_CHARS ? { kind: 'set', value: block, notice } : { kind: 'omit', notice };
+}
+const styleBodyReadOf = (settings) => () => typeof settings === 'object' && settings !== null ? slotReadOf(settings, 'outputStyle') : undefined;
+const appendBodyReadOf = (req) => () => typeof req === 'object' && req !== null ? slotReadOf(req, 'appendSystemPrompt') : undefined;
+function settingsWithStyleSeat(settings, seat) {
+    const next = {};
+    const put = (key, value) => {
+        Object.defineProperty(next, key, { value, writable: true, enumerable: true, configurable: true });
+    };
+    const src = Object(settings);
+    let placed = false;
+    for (const key of Reflect.ownKeys(src)) {
+        const d = Object.getOwnPropertyDescriptor(src, key);
+        if (d === undefined || d.enumerable !== true)
+            continue;
+        if (key === 'outputStyle') {
+            if (seat.kind === 'set')
+                put(key, seat.value);
+            placed = true;
+            continue;
+        }
+        put(key, src[key]);
+    }
+    if (!placed && seat.kind === 'set')
+        put('outputStyle', seat.value);
+    return Reflect.ownKeys(next).length > 0 ? next : undefined;
+}
+function liveRequestDefaultsOf(req, host) {
+    const notices = [];
     const out = { ...req };
     if (out.cwd == null && host.cwd !== undefined)
         out.cwd = host.cwd;
@@ -1249,11 +1353,24 @@ export function applyLiveRequestDefaults(req, host) {
     }
     if (host.selfKnowledge !== undefined) {
         if (host.appendSystemPromptCapable) {
-            out.appendSystemPrompt = host.selfKnowledge.forAppend;
+            const seat = selfKnowledgeSeatOf(host.selfKnowledge.forAppend, appendBodyReadOf(req));
+            if (seat.notice !== undefined)
+                appendOwnElement(notices, seat.notice);
+            if (seat.kind === 'set')
+                out.appendSystemPrompt = seat.value;
+            else
+                delete out.appendSystemPrompt;
         }
         else {
             const settings = (out.settings ?? {});
-            out.settings = { ...settings, outputStyle: host.selfKnowledge.forOutputStyle };
+            const seat = selfKnowledgeSeatOf(host.selfKnowledge.forOutputStyle, styleBodyReadOf(settings));
+            if (seat.notice !== undefined)
+                appendOwnElement(notices, seat.notice);
+            const next = settingsWithStyleSeat(settings, seat);
+            if (next !== undefined)
+                out.settings = next;
+            else
+                delete out.settings;
         }
     }
     if (out.outputStyle === undefined && host.outputStyleSeat !== undefined && outputStyleSeatAdmitted(host.outputStyleSeatReading)) {
@@ -1276,7 +1393,7 @@ export function applyLiveRequestDefaults(req, host) {
         delete out.sessionId;
     }
     refuseRequireExistingWithoutSession(out.requireExistingSession, out.sessionId, 'applyLiveRequestDefaults');
-    return out;
+    return Object.freeze({ request: out, notices: Object.freeze(notices) });
 }
 export function unregisteredRequestKeys(req, lane) {
     const liveDefaults = liveDefaultKeyNames();

package/dist/resumeRefusalCopy.d.ts

@@ -43,12 +43,10 @@ export interface ParkedResumeStartupDetail {
     code: string;
     cause: ParkedResumeStartupCause;
     taskId?: string;
-    startupCause?: ResumeStartupCause | ResumeCauseCoreAhead;
+    startupCause?: ResumeStartupCause;
     resendable: false;
     denyStaysOpen: true;
 }
-declare const RESUME_CAUSE_CORE_AHEAD: readonly ["transcript_corrupt"];
-type ResumeCauseCoreAhead = Exclude<(typeof RESUME_CAUSE_CORE_AHEAD)[number], ResumeStartupCause>;
 export declare function parkedResumeStartupFromError(err: unknown, decision?: ParkedResumeStartupDecision): ParkedResumeStartupDetail | null;
 export declare function parkedResumeStartupContent(detail: ParkedResumeStartupDetail, lang?: UiLanguage): string;
 export interface CheckpointUnsupportedVersionDetail {

package/dist/resumeRefusalCopy.js

@@ -132,7 +132,6 @@ function parkedResumeStartupCauseWord(err) {
 function isResumeStartupCause(v) {
     return typeof v === 'string' && CORE_RESUME_STARTUP_CAUSES.includes(v);
 }
-const RESUME_CAUSE_CORE_AHEAD = Object.freeze(['transcript_corrupt']);
 const _startupCausePin = true;
 void _startupCausePin;
 export function parkedResumeStartupFromError(err, decision) {
@@ -349,3 +348,5 @@ export function refusedParkBlockedContent(taskId, lane = 'interactive', lang) {
         return renderMessage(msg('resume.refusal.park.blockedPrint', { run, cancel: `POST /v1/runs/${runId ?? '<run id>'}/cancel` }), lang);
     return renderMessage(msg('resume.refusal.park.blockedInteractive', { run }), lang);
 }
+const _pinRefusedPark = [true, true, true];
+void _pinRefusedPark;

package/dist/retryStatus.d.ts

@@ -1,3 +1,4 @@
+import type { BrainStatusPhase } from '@sema-agent/sdk';
 import type { UiLanguage } from './env/uiLanguage.js';
 export type RetryStatus = {
     kind: 'stalled';
@@ -62,7 +63,7 @@ interface RetryStatusErrorPayload {
     } | null;
 }
 export declare const BRAIN_STATUS_PHASES: readonly ["rate_limited", "retrying", "reconnecting", "circuit_open", "recovered", "gave_up", "waiting_first_token"];
-export type BrainStatusPhase = (typeof BRAIN_STATUS_PHASES)[number];
+export type { BrainStatusPhase };
 export type BrainRetryErrClass = 'connect_refused' | 'transport' | 'stall' | 'rate_limit' | 'server' | 'http' | 'output_cap';
 export interface BrainStatusPayload {
     phase: BrainStatusPhase | (string & {});
@@ -161,4 +162,3 @@ export interface ResultWayOut {
 }
 export declare function resultWayOutOf(frame: object | null | undefined): ResultWayOut | undefined;
 export declare function wayOutSentence(wayOut: ResultWayOut | null | undefined, lang?: UiLanguage): string | undefined;
-export {};

package/dist/retryStatus.js

@@ -11,6 +11,8 @@ export const BRAIN_STATUS_PHASES = [
     'gave_up',
     'waiting_first_token',
 ];
+const _brainStatusPhasePin = [true, true];
+void _brainStatusPhasePin;
 export const BRAIN_STATUS_WAIT_SEGMENTS = Object.freeze(['response_headers', 'first_token']);
 void true;
 void true;

package/dist/ruleReadings.js

@@ -122,7 +122,7 @@ export function ruleNearMissSentence(rows, lang) {
     const named = shown
         .map((it) => renderMessage(msg('rules.refusal.item', {
         rule: `"${capForDisplay(it.rule, NEAR_MISS_RULE_MAX)}"`,
-        reason: renderMessage(msg('rules.nearMiss.reason', { mounted: capForDisplay(displayUntrusted(it.mounted), NEAR_MISS_NAME_MAX) }), lang),
+        reason: renderMessage(msg('rules.nearMiss.reason', { mounted: displayUntrusted(it.mounted, { max: NEAR_MISS_NAME_MAX, escapeBackslashes: 'auto' }) }), lang),
     }), lang))
         .join(separator);
     const rest = items.length - shown.length;

package/dist/seam.d.ts

@@ -8,6 +8,8 @@ import type { SuspendedReopenReading } from './hitl/suspendedReopen.js';
 import type { PlanReviewCardFacts } from './planReviewCardFacts.js';
 import type { ToolKillCause } from './toolResult.js';
 import type { HumanInputAttachmentView } from './ownKey.js';
+import type { SubagentAliasScope } from './subagentContentStore.js';
+import type { SessionBoxNoticeFacts } from './peerFrames.js';
 import type { TaskNotificationFields } from './notifications.js';
 export interface AbortSignalLike {
     readonly aborted: boolean;
@@ -165,7 +167,7 @@ export type ChromeEvent = {
 } | ({
     kind: 'run_cost_reconciled';
     laneProof: LaneProof;
-} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | CompactionStartedChromeEvent | SubagentStartedChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | ApprovalCompleteChromeEvent | SessionTitledChromeEvent | {
+} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | CompactionStartedChromeEvent | SubagentStartedChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | SubagentAliasChromeEvent | SessionBoxNoticeChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | ApprovalCompleteChromeEvent | SessionTitledChromeEvent | {
     kind: 'suspended_reopened';
     laneProof: LaneProof;
     reopen: Extract<SuspendedReopenReading, {
@@ -347,6 +349,21 @@ export interface ToolParkedChromeEvent {
     toolUseId: string;
     rowUuid?: string;
 }
+export interface SubagentAliasChromeEvent {
+    kind: 'subagent_alias';
+    laneProof: LaneProof;
+    parentToolCallId: string;
+    taskId: string;
+    scope: SubagentAliasScope;
+    seq?: number;
+}
+export type SessionBoxNoticeChromeEvent = SessionBoxNoticeChromeEnvelope & SessionBoxNoticeFacts;
+export interface SessionBoxNoticeChromeEnvelope {
+    kind: 'session_box_notice';
+    laneProof: LaneProof;
+    text: string;
+    rowUuid: string;
+}
 export interface EngineNoticeChromeEvent {
     kind: 'engine_notice';
     laneProof: LaneProof;
@@ -376,8 +393,13 @@ export interface HumanInputChromeEvent {
     entryId?: string;
     eventId?: string;
     attachments?: HumanInputAttachmentView[];
+    author?: string;
+    authorUnreadable?: true;
+    extension?: string;
+    runOrigin?: string;
+    runOriginUnreadable?: true;
 }
-export type { HumanInputAttachmentView } from './ownKey.js';
+export type { HumanInputAttachmentView, HumanInputAttachmentDeclinedByView } from './ownKey.js';
 export interface MessageCommittedChromeEvent {
     kind: 'message_committed';
     laneProof: LaneProof;

package/dist/seam.js

@@ -140,6 +140,18 @@ const CHROME_ARM_TABLE = {
             '按开始行 uuid 认行,不按 toolUseId(调用 id 只在同一条助手消息内唯一)。它的终态由执行腿的结果铸(续跑带见证时接回原行),或永远缺席(停驻被取消 / 过期)。' +
             '连坐旁观者 / 普通错误 / 停驻卡上 Esc(包已自发中断拒绝,行照铸 Interrupted)零枚。',
     },
+    subagent_alias: {
+        required: false,
+        duty: '可选:「委派卡 id → 子代任务 id」别名对(`parentToolCallId` / `taskId` / `scope`)—— 座位 lane 的渲染端收到就调 `noteSeatSubagentAlias(chrome)` 写自己账本里的同一半,' +
+            '子代详情的实时输出才按子代任务 id 读得到(子代内容帧只带卡 id)。🔴 座位宿主零逻辑:本臂在座位词表里,按词表转发的宿主自动转发;适配层与渲染层同进程的端(浏览器 lane)适配层已登记,什么都不用做;' +
+            '`scope: content` 只写内容归账那一半、`full` 两半都写(含续发目标),别把两者混着登;`full` 臂的 `seq`(帧自带代际号,可缺席)是续发目标「现卡」的顺序证据,交 `noteSeatSubagentAlias` 即可,别自己按到达序排;适配层每次登记都发(tick 逐条各一只),去重在登记口:同对重复收到答 ignored、无副作用;认不得的 `scope` 词整条不登记(读口答 undefined),别猜。',
+    },
+    session_box_notice: {
+        required: false,
+        duty: '可选:会话箱通告 —— `noticeKind: inbox`(收件箱一行:pending / delivered 必有,urgent / resupplied 缺席 = 引擎没说,不渲 0)/ `delivery`(投递回执)/ `idle`(对端空闲)。' +
+            '渲 `text`(数据面英文)或按界面语言调 `sessionBoxNoticeSentence(本臂, lang)`;🔴 同一条通告有两个载体(转录行 + 本臂),接本臂的宿主按 `rowUuid` 把那一行摘掉、只渲一个;' +
+            '`state` 是开集机读位,别回显、别按它猜句子;typed 正体缺席时本臂整个不发(不铸状态词)。',
+    },
     result_text_diverged: {
         required: false,
         duty: '可选:终帧正文与已上屏正文**互相都不是对方前缀**时的诚实披露。🔴 处置是把这一拍的转录行**改口**' +
@@ -151,7 +163,7 @@ const CHROME_ARM_TABLE = {
         required: true,
         duty: '用 sdk isApprovalRequestFrameV1 窄化 frame 才取 card/askId/窗三键;窄不下来 ⇒ 呈通用卡(安全元数据 + 人工 approve/deny),' +
             '🔴 永不 auto-deny;开卡前调 claimApprovalCard(身份, { signal }):joined / aborted ⇒ 不开卡,held ⇒ 开卡且每条出口恰调一次 hold.release(settled?)' +
-            '(去重判定归包 —— legacy 帧那一路的持有与结局在进程级持有表 / 已结表里,宿主不自持 legacy 已收口集);流上下文经 approvalFrameContextOf(这只 chrome 事件) 查,查不到不开卡;' +
+            '(去重判定归包 —— 同一只审批的活卡 / 停驻行 / 另一条宿主路的持有与结局在进程级持有表 / 已结表里,宿主不自持已收口集;服务端 7.133.0 起一条腿一个帧族,不再有先旧族帧、后本帧的并发);流上下文经 approvalFrameContextOf(这只 chrome 事件) 查,查不到不开卡;' +
             '🔴 账本重放的历史帧只用于时间线渲染,卡集的全量对账基准是开流 preamble(它带的 expiresInMs 是铸帧时刻的旧值);' +
             'card 的 message/args 是模型/工具产文,只渲染永不回喂模型',
     },
@@ -170,7 +182,8 @@ const CHROME_ARM_TABLE = {
     },
     approval_complete: {
         required: true,
-        duty: '用 sdk isApprovalCompleteFrameV1 窄化 frame 取 askId/outcome/cause/parked;窄不下来按 askId(若有)清卡、别猜结局;按开卡帧的 askId 清本地卡' +
+        duty: '结局三态只读 classifyApprovalCompleteFrame(frame)(live-expired-parked / live-expired-retract / settled;null = 认不出、别猜结局),不自拼 outcome / cause / parked 的读法;' +
+            '清卡用的 askId 经 sdk isApprovalCompleteFrameV1 窄化取,窄不下来按 askId(若有)清卡;按开卡帧的 askId 清本地卡,三态任一都清' +
             '(与撤卡帧不冲突,两帧都可能到;清卡是这张卡的一条出口,呈卡臂登记的持有句柄照放);🔴 永不据本帧推断 run 的归宿(读 run 行 / 停驻面),' +
             'expired 不是拒绝,带 parked 的是转进耐久队列、还在等人;账本重放的消卡帧只用于时间线渲染,卡集对账基准恒为开流 preamble(帧可能整帧丢失)',
     },