@sema-agent/client-core 0.101.0 → 0.102.0

package/dist/engineRowRef.js

@@ -100,6 +100,7 @@ export const TRANSCRIPT_ROW_SIDECAR_KEYS = Object.freeze([
     '_sema_row_kind',
     '_sema_coded_detail',
     '_sema_task_notification',
+    '_sema_answered_by',
 ]);
 export function parkHeldCallIdOf(carrier) {
     return readFrameStringKey(carrier, 'toolCallId');

package/dist/fleet/fleetProjection.js

@@ -328,7 +328,7 @@ export const FLEET_TASK_ROW_KEYS_NOT_PROJECTED = {
         kind: 'by-design',
         owner: 'client-core 规范重构轮',
         reason: 'SDK 3.0.0 新键([2070]① 让位半场:前台 delegation 复合 id 行带 "run-leg" 标)。**渲染视图**(FleetTaskView)不投 —— 渲染面没有按车道分支的需求,' +
-            '#95 纪律:没人读的键不盲投。🆕 0.96.0 CC-643 起它有了消费者,但住在另一张读面:在飞 bg 读面行(EngineActiveBgTask)投了它,' +
+            '纪律:没人读的键不盲投。🆕 0.96.0 CC-643 起它有了消费者,但住在另一张读面:在飞 bg 读面行(EngineActiveBgTask)投了它,' +
             '「这一行是不是后台子代」的单一判定口 isBackgroundSubagentRow 读它(见 fleet/bgSubagentRow.ts);视图不投的理由不变,不是第二份真源。',
     },
     agentType: {

package/dist/i18n/messages.en.d.ts

@@ -1010,6 +1010,44 @@ declare const EN: {
     'config.hooks.plan.reason.compactionLocalFallback': string;
     'session.hooks.compactTransition.disclosure.engineOutcomeUnknown': string;
     'session.hooks.compactTransition.disclosure.neitherRan': string;
+    'session.background.handedOff': string;
+    'session.background.refusal.noRun': string;
+    'session.background.refusal.streamEnded': string;
+    'session.background.refusal.notStarted': string;
+    'session.background.refusal.alreadyHandedOff': string;
+    'session.background.refusal.finished': string;
+    'session.background.refusal.stopping': string;
+    'session.background.refusal.engineReplaced': string;
+    'session.background.refusal.declined': string;
+    'session.background.refusal.envOff': string;
+    'session.background.refusal.notReattachable': string;
+    'session.background.refusal.unconfirmed': string;
+    'session.background.refusal.durableOff': string;
+    'session.background.refusal.awaitingUser': string;
+    'session.background.unknown': string;
+    'session.background.hostNotNotified': string;
+    'session.background.settled.completed': string;
+    'session.background.settled.failed': string;
+    'session.background.settled.cancelled': string;
+    'session.background.settled.parked': string;
+    'session.background.settled.observationStopped': string;
+    'session.background.busy': string;
+    'session.thinking.state.on': string;
+    'session.thinking.state.off': string;
+    'session.thinking.state.unset': string;
+    'session.thinking.offWithUltracodeOnBody': string;
+    'session.thinking.modelCannotThink': string;
+    'session.thinking.storeUnreadable': string;
+    'session.thinking.notSaved': string;
+    'config.mods.card.mounted': string;
+    'config.mods.card.refused': string;
+    'config.mods.card.none': string;
+    'config.mods.card.counts': string;
+    'config.mods.card.countsWithRefused': string;
+    'config.mods.loader.failed': string;
+    'config.mods.loader.failedNoReason': string;
+    'config.mods.refusal.by': string;
+    'config.mods.rewrite.resultInPlace': string;
 };
 export declare const EN_MESSAGES: Readonly<typeof EN>;
 export type MessageKey = keyof typeof EN;

package/dist/i18n/messages.en.js

@@ -1010,5 +1010,43 @@ const EN = {
     'config.hooks.plan.reason.compactionLocalFallback': 'this compaction is summarized on this client because the engine session is unavailable, so the engine will not run it and this client runs it itself',
     'session.hooks.compactTransition.disclosure.engineOutcomeUnknown': 'The compaction request had already been sent to the engine when the summary fell back to this client, so whether the engine ran the compaction hooks cannot be told here, and this client did not run them again.',
     'session.hooks.compactTransition.disclosure.neitherRan': 'The compaction hooks did not run this time: the engine did not compact here and this client could not start its own summary. If the engine still compacts later it will run them then.',
+    'session.background.handedOff': "Moved to the background. You'll be told when it finishes.",
+    'session.background.refusal.noRun': "There's no answer running from this screen that can be moved to the background.",
+    'session.background.refusal.streamEnded': "This answer is no longer on its original live connection, so it can't be moved to the background from here.",
+    'session.background.refusal.notStarted': "The engine hasn't started streaming this answer yet. Try again in a moment.",
+    'session.background.refusal.alreadyHandedOff': 'This answer is already in the background.',
+    'session.background.refusal.finished': 'This answer has already finished.',
+    'session.background.refusal.stopping': "This answer is being stopped, so it can't move to the background.",
+    'session.background.refusal.engineReplaced': "The engine running this answer has stopped or been replaced; it can't be moved.",
+    'session.background.refusal.declined': "This answer can't move to the background: this engine doesn't keep answers running after you leave. It will finish here.",
+    'session.background.refusal.envOff': 'Background hand-off is turned off (SEMA_HEADLESS_DETACH). This answer will finish here.',
+    'session.background.refusal.notReattachable': "This answer can't move to the background: this window can't reconnect to an answer running elsewhere.",
+    'session.background.refusal.unconfirmed': "This answer can't move to the background: the engine hasn't confirmed it can keep answers running on its own.",
+    'session.background.refusal.durableOff': "This answer can't move to the background: the engine said it can't keep this answer running after you leave.",
+    'session.background.refusal.awaitingUser': "Answer the open question first — an answer that is waiting for you can't move to the background.",
+    'session.background.unknown': "Couldn't confirm this answer can safely move to the background, so it stays here.",
+    'session.background.hostNotNotified': "Moved to the background, but this screen didn't update cleanly.",
+    'session.background.settled.completed': 'The background answer finished.',
+    'session.background.settled.failed': 'The background answer stopped with an error ({code}).',
+    'session.background.settled.cancelled': 'The background answer was cancelled.',
+    'session.background.settled.parked': 'The background answer is waiting for approval; open it to continue.',
+    'session.background.settled.observationStopped': 'Lost track of the background answer. It may still be running — check the task list.',
+    'session.background.busy': "This conversation's answer is still running in the background. Wait for it to finish, or start a new conversation.",
+    'session.thinking.state.on': 'Thinking on',
+    'session.thinking.state.off': 'Thinking off',
+    'session.thinking.state.unset': 'Thinking not set: the effort setting decides, or the engine default when there is none',
+    'session.thinking.offWithUltracodeOnBody': 'This message carries both Ultracode and thinking off; the engine decides which one applies.',
+    'session.thinking.modelCannotThink': 'Thinking is on, but the model {model} does not use extended thinking, so this setting has no effect on it.',
+    'session.thinking.storeUnreadable': 'The thinking setting could not be read, so it is treated as not set: no thinking override is applied and the effort setting decides.',
+    'session.thinking.notSaved': 'The thinking setting was not saved, so it may not have changed.',
+    'config.mods.card.mounted': '{name} is loaded',
+    'config.mods.card.refused': '{name} was not loaded: {refusedBy} refused it — {reason}',
+    'config.mods.card.none': 'No mods registered on this leg',
+    'config.mods.card.counts': '{n} mounted',
+    'config.mods.card.countsWithRefused': '{n} mounted, {m} refused',
+    'config.mods.loader.failed': '{name} could not be loaded: {reason}',
+    'config.mods.loader.failedNoReason': '{name} could not be loaded',
+    'config.mods.refusal.by': 'Refused by {by}',
+    'config.mods.rewrite.resultInPlace': 'Answered by {by} in place of the tool',
 };
 export const EN_MESSAGES = Object.freeze(EN);

package/dist/i18n/messages.zh.js

@@ -1010,9 +1010,49 @@ const ZH = {
     'config.hooks.plan.reason.compactionLocalFallback': '这一次压缩的摘要因引擎会话不可用而在本客户端本地生成，引擎不会替它运行这只 hook，所以由本客户端自己运行',
     'session.hooks.compactTransition.disclosure.engineOutcomeUnknown': '摘要改走本客户端时，压缩请求已经发给了引擎，所以引擎有没有运行压缩 hook 这里判不了，本客户端也没有再运行一遍。',
     'session.hooks.compactTransition.disclosure.neitherRan': '这一次压缩 hook 没有运行：引擎没有在这里压缩，本客户端的本地摘要也没能启动。引擎之后若仍会压缩，到时会运行它们。',
+    'session.background.handedOff': '已转到后台，结束时会告诉你。',
+    'session.background.refusal.noRun': '这块屏上没有可以转后台的、正在跑的回答。',
+    'session.background.refusal.streamEnded': '这条回答已不在最初的实时连接上，不能从这里转后台。',
+    'session.background.refusal.notStarted': '引擎还没开始输出这条回答，稍后再试。',
+    'session.background.refusal.alreadyHandedOff': '这条回答已经在后台了。',
+    'session.background.refusal.finished': '这条回答已经结束了。',
+    'session.background.refusal.stopping': '这条回答正在被停止，不能转后台。',
+    'session.background.refusal.engineReplaced': '跑这条回答的引擎已停止或被替换，无法转后台。',
+    'session.background.refusal.declined': '无法转后台：这台引擎不会在你离开后继续跑回答。它会在这里跑完。',
+    'session.background.refusal.envOff': '送后台已被关闭（SEMA_HEADLESS_DETACH）。这条回答会在这里跑完。',
+    'session.background.refusal.notReattachable': '无法转后台：这个窗口接不回在别处跑的回答。',
+    'session.background.refusal.unconfirmed': '无法转后台：引擎还没确认它能独立跑完回答。',
+    'session.background.refusal.durableOff': '无法转后台：引擎表示你离开后它没法继续跑这条回答。',
+    'session.background.refusal.awaitingUser': '先回答屏上的问题 —— 正在等你回答的回答不能转后台。',
+    'session.background.unknown': '没法确认这条回答能安全转后台，所以它留在这里。',
+    'session.background.hostNotNotified': '已转到后台，但这块屏没能正常收尾。',
+    'session.background.settled.completed': '后台回答已完成。',
+    'session.background.settled.failed': '后台回答出错停止（{code}）。',
+    'session.background.settled.cancelled': '后台回答已取消。',
+    'session.background.settled.parked': '后台回答停在等批准上，打开它继续。',
+    'session.background.settled.observationStopped': '看不到后台回答了。它可能还在跑 —— 去任务列表看。',
+    'session.background.busy': '这个对话的回答还在后台跑。等它结束，或开个新对话。',
+    'session.thinking.state.on': '思考已开启',
+    'session.thinking.state.off': '思考已关闭',
+    'session.thinking.state.unset': '思考未设置：由思考档位决定，没有档位时交给引擎默认',
+    'session.thinking.offWithUltracodeOnBody': '这条消息同时带了 Ultracode 与关闭思考，以哪个为准由引擎决定。',
+    'session.thinking.modelCannotThink': '思考已开启，但模型 {model} 不使用扩展思考，这一设置对它不起作用。',
+    'session.thinking.storeUnreadable': '读不出思考设置，按未设处理：不加开关的限制，由思考档位决定。',
+    'session.thinking.notSaved': '思考设置没有存上，可能没有改变。',
+    'config.mods.card.mounted': '{name} 已装载',
+    'config.mods.card.refused': '{name} 没有装载：{refusedBy} 拒绝了它 —— {reason}',
+    'config.mods.card.none': '本腿没有注册的 mod',
+    'config.mods.card.counts': '{n} 已装载',
+    'config.mods.card.countsWithRefused': '{n} 已装载，{m} 被拒',
+    'config.mods.loader.failed': '{name} 装载失败：{reason}',
+    'config.mods.loader.failedNoReason': '{name} 装载失败',
+    'config.mods.refusal.by': '被 {by} 拒绝',
+    'config.mods.rewrite.resultInPlace': '由 {by} 代替工具作答',
 };
 export const ZH_MESSAGES = Object.freeze(ZH);
 export const TERM_SLOTS = Object.freeze({
+    'session.background.refusal.envOff': ['SEMA_HEADLESS_DETACH'],
+    'session.thinking.offWithUltracodeOnBody': ['Ultracode'],
     'config.mcp.toolAxesInvalid': ['toolAxes'],
     'config.mcp.toolFacesInvalid': ['toolFaces'],
     'config.mcp.cloudToolAxesInvalid': ['toolAxes'],

package/dist/index.d.ts

@@ -161,6 +161,8 @@ export * from './effortWire.js';
 export * from './adapter/types.js';
 export * from './adapter/downstream/turnUsageToModelUsage.js';
 export * from './adapter/downstream/eventToSdkMessage.js';
+export { MOD_LOADER_VERBS, readModRegistrationRefusedNotice, modCardSentence, modLoaderFailureSentence, type ModLoaderVerb } from './modsFace.js';
+export { modRowsOf } from './adapter/downstream/wiringManifestView.js';
 export type { WiringManifestView, WiringManifestSections, WiringManifestFleetView } from './adapter/downstream/wiringManifestView.js';
 export { wiringFleetDoctorDetail } from './wiringFleetDoctor.js';
 export * from './adapter/downstream/terminalToSdkResult.js';
@@ -352,6 +354,10 @@ export * from './hitl/askSettlementLine.js';
 export * from './interactiveHalt.js';
 export { fireInteractiveInterrupt } from './interactiveInterrupt.js';
 export type { InteractiveInterruptRuns, InteractiveInterruptOptions } from './interactiveInterrupt.js';
+export { readSessionBackgroundable, projectSessionBackgroundable, interactiveEngineWire, retireInteractiveEngineWire, interactiveDetachPosture, streamInteractiveRun, backgroundHandoffEligibility, backgroundHandoffSentence, interactiveStopFacts, } from './sessionBackground.js';
+export type { SessionBackgroundableReading, InteractiveEngineLane, InteractiveEngineWireInit, InteractiveEngineWire, InteractiveOpeningInput, InteractiveDetachPostureReason, InteractiveDetachPosture, InteractiveStreamOptions, BackgroundHandoffVerdict, BackgroundHandoffRefusal, BackgroundHandoffUnknown, InteractiveStopFacts, } from './sessionBackground.js';
+export { BACKGROUND_HANDOFF_ABORT_REASON, handoffInteractiveRun, handedOffRunsOf, forgetHandedOffRun } from './sessionBackgroundHandoff.js';
+export type { BackgroundHandoffRequest, BackgroundHandoffOutcome, BackgroundRun, BackgroundRunSettlement, HandedOffRunRow, HandedOffRunsReading, } from './sessionBackgroundHandoff.js';
 export { listDevices, readSessionBinding, rebindSession, reconcileRebindOutcome, rebindProvesRequestNotApplied } from './deviceRebind.js';
 export { issueEnrollToken, enrollDevice, revokeDevice, deviceIdentityMismatchOf, deviceIdentityMismatchLine, deviceRegistrationOutcomeLine } from './deviceRebind.js';
 export type { DeviceSummary, DeviceListResult, DeviceBinding, DeviceSessionBinding, DeviceRebindRequest, DeviceRevokeRequest, DeviceRebindResult, DeviceEnrollToken, DeviceEnrollRequest, DeviceEnrollResult, DeviceRevokeResult, } from '@sema-agent/sdk';
@@ -363,6 +369,8 @@ export * from './request/printNotification.js';
 export * from './seatContract.js';
 export { mcpToolTogglesToExcludeTools } from './mcpToolToggles.js';
 export type { McpToolToggleKey, McpMountedServers } from './mcpToolToggles.js';
+export { readThinkingLatch, writeThinkingLatch, thinkingLatchView, thinkingLatchSentence, thinkingLatchRowWordOf, readSeatThinkingLatch } from './thinkingLatch.js';
+export type { ThinkingLatchState, ThinkingLatchEvent, ThinkingLatchRowWord, ThinkingLatchStorePort, ThinkingLatchReading, ThinkingLatchWriteOutcome, ThinkingLatchView, ThinkingLatchCarrier, ThinkingLatchSentenceSubject, } from './thinkingLatch.js';
 export { devicesFaceOf, devicesWritesAllowed, devicesFaceDetail } from './devicesFace.js';
 export type { DevicesFace, DevicesFaceInput, DevicesFaceUnavailableWhy } from './devicesFace.js';
 export { cloudLoginFailureOf, cloudLoginFailureText, engineTargetRefusalText, seatMcpReadingOf, watchEngineTarget } from './engineTargetSeat.js';

package/dist/index.js

@@ -139,6 +139,8 @@ export * from './effortWire.js';
 export * from './adapter/types.js';
 export * from './adapter/downstream/turnUsageToModelUsage.js';
 export * from './adapter/downstream/eventToSdkMessage.js';
+export { MOD_LOADER_VERBS, readModRegistrationRefusedNotice, modCardSentence, modLoaderFailureSentence } from './modsFace.js';
+export { modRowsOf } from './adapter/downstream/wiringManifestView.js';
 export { wiringFleetDoctorDetail } from './wiringFleetDoctor.js';
 export * from './adapter/downstream/terminalToSdkResult.js';
 export { resultErrorCodeOf, resultSelectedModelOf, resultSalvagedResultOf, resultParkFailedReasonOf } from './resultFrameKeys.js';
@@ -288,6 +290,8 @@ export { approvalCompleteCauseOf } from './hitl/approvalEndingCause.js';
 export * from './hitl/askSettlementLine.js';
 export * from './interactiveHalt.js';
 export { fireInteractiveInterrupt } from './interactiveInterrupt.js';
+export { readSessionBackgroundable, projectSessionBackgroundable, interactiveEngineWire, retireInteractiveEngineWire, interactiveDetachPosture, streamInteractiveRun, backgroundHandoffEligibility, backgroundHandoffSentence, interactiveStopFacts, } from './sessionBackground.js';
+export { BACKGROUND_HANDOFF_ABORT_REASON, handoffInteractiveRun, handedOffRunsOf, forgetHandedOffRun } from './sessionBackgroundHandoff.js';
 export { listDevices, readSessionBinding, rebindSession, reconcileRebindOutcome, rebindProvesRequestNotApplied } from './deviceRebind.js';
 export { issueEnrollToken, enrollDevice, revokeDevice, deviceIdentityMismatchOf, deviceIdentityMismatchLine, deviceRegistrationOutcomeLine } from './deviceRebind.js';
 export { resolveEngineEnvSourcing, engineEnvView } from './engineEnvSourcing.js';
@@ -295,6 +299,7 @@ export * from './compensations.js';
 export * from './request/printNotification.js';
 export * from './seatContract.js';
 export { mcpToolTogglesToExcludeTools } from './mcpToolToggles.js';
+export { readThinkingLatch, writeThinkingLatch, thinkingLatchView, thinkingLatchSentence, thinkingLatchRowWordOf, readSeatThinkingLatch } from './thinkingLatch.js';
 export { devicesFaceOf, devicesWritesAllowed, devicesFaceDetail } from './devicesFace.js';
 export { cloudLoginFailureOf, cloudLoginFailureText, engineTargetRefusalText, seatMcpReadingOf, watchEngineTarget } from './engineTargetSeat.js';
 export { KEY_SLOT_PREFIX, keyEnvNameForEntry, onboardBaseUrlProblem, onboardRefusalText, onboardWritePlan, onboardWriteVerdict, poolEntryNameOf, probeModelEndpoint, } from './model/onboardJudgement.js';

package/dist/interactiveHalt.d.ts

@@ -11,13 +11,15 @@ export type InteractiveHaltInterruptOutcome = {
 } | {
     kind: 'transport';
     detail?: string | undefined;
+} | {
+    kind: 'withheld';
 };
 export interface InteractiveHaltInput {
     readonly parked?: boolean | undefined;
     readonly detachArmed?: boolean | undefined;
     readonly interruptOutcome?: InteractiveHaltInterruptOutcome | undefined;
 }
-export type InteractiveHaltReason = 'first-shot' | 'halted' | 'engine-says-run-level' | 'no-verdict-on-parked-card' | 'no-verdict-detach-armed' | 'no-verdict-not-parked' | 'refused-no-escalation' | 'unknown-outcome';
+export type InteractiveHaltReason = 'first-shot' | 'halted' | 'engine-says-run-level' | 'no-verdict-on-parked-card' | 'no-verdict-detach-armed' | 'no-verdict-not-parked' | 'refused-no-escalation' | 'unknown-outcome' | 'handed-off';
 export interface InteractiveHaltPlan {
     readonly action: 'interrupt' | 'escalate-cancel' | 'none';
     readonly reason: InteractiveHaltReason;

package/dist/interactiveHalt.js

@@ -32,6 +32,8 @@ export function planInteractiveHalt(input) {
             ? { action: 'escalate-cancel', reason: 'engine-says-run-level' }
             : { action: 'none', reason: 'refused-no-escalation' };
     }
+    if (kind === 'withheld')
+        return { action: 'none', reason: 'handed-off' };
     if (kind === 'transport' || kind === 'unarmed') {
         if (input.parked === true)
             return { action: 'escalate-cancel', reason: 'no-verdict-on-parked-card' };

package/dist/interactiveInterrupt.d.ts

@@ -1,8 +1,10 @@
 import type { AgentClient } from '@sema-agent/sdk';
 import type { InteractiveHaltInterruptOutcome } from './interactiveHalt.js';
+import { type InteractiveEngineWire } from './sessionBackground.js';
 export type InteractiveInterruptRuns = Pick<AgentClient['runs'], 'interrupt'>;
 export interface InteractiveInterruptOptions {
     readonly sessionId?: string | undefined;
     readonly signal?: AbortSignal | undefined;
+    readonly wire?: InteractiveEngineWire | undefined;
 }
 export declare function fireInteractiveInterrupt(runs: InteractiveInterruptRuns | null | undefined, taskId: string, opts?: InteractiveInterruptOptions): Promise<InteractiveHaltInterruptOutcome>;

package/dist/interactiveInterrupt.js

@@ -1,5 +1,6 @@
 import { atMostOnceVerdictOf } from './atMostOnce.js';
 import { readOwnDataValue } from './ownKey.js';
+import { noteInteractiveStopRequested, ownSlotOf } from './sessionBackground.js';
 function guardedSlot(e, key) {
     if (e === null || (typeof e !== 'object' && typeof e !== 'function'))
         return undefined;
@@ -33,6 +34,20 @@ function turnCutOf(receipt) {
     }
 }
 export async function fireInteractiveInterrupt(runs, taskId, opts = {}) {
+    if (opts !== null && typeof opts === 'object') {
+        const ws = ownSlotOf(opts, 'wire');
+        if (ws.state === 'unreadable')
+            return { kind: 'withheld' };
+        if (ws.state === 'data') {
+            const wire = ws.value;
+            if (wire !== null) {
+                if (typeof wire !== 'object')
+                    return { kind: 'withheld' };
+                if (noteInteractiveStopRequested(wire, taskId) === 'withheld')
+                    return { kind: 'withheld' };
+            }
+        }
+    }
     const verb = guardedSlot(runs, 'interrupt');
     if (typeof verb !== 'function')
         return { kind: 'unarmed' };

package/dist/modsFace.d.ts

@@ -0,0 +1,8 @@
+import type { WiringManifestModRefusedView } from './adapter/downstream/eventToSdkMessage.js';
+import type { EngineNoticeChromeEvent } from './seam.js';
+import type { UiLanguage } from './env/uiLanguage.js';
+export declare const MOD_LOADER_VERBS: readonly ["list", "load", "unload", "status"];
+export type ModLoaderVerb = (typeof MOD_LOADER_VERBS)[number];
+export declare function readModRegistrationRefusedNotice(ev: EngineNoticeChromeEvent): WiringManifestModRefusedView | undefined;
+export declare function modCardSentence(input: object | null | undefined, lang?: UiLanguage): string | undefined;
+export declare function modLoaderFailureSentence(name: string, error: unknown, lang?: UiLanguage): string;

package/dist/modsFace.js

@@ -0,0 +1,59 @@
+import { modRowsOf } from './adapter/downstream/wiringManifestView.js';
+import { msg, renderMessage } from './i18n/translate.js';
+import { displayUntrusted } from './displayUntrusted.js';
+import { WIRE_FAILURE_UNRENDERABLE_TEXT, wireFailureTextsOf } from './wireFailureShape.js';
+import { gateOutcomeOf, isDeniedGate } from './gateOutcome.js';
+import { guardedRead, readOwnDataNonEmptyString, readOwnDataValue, toolResultBlockOf } from './ownKey.js';
+const isCardRecordObject = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+export const MOD_LOADER_VERBS = Object.freeze(['list', 'load', 'unload', 'status']);
+const modRowOf = (r) => modRowsOf([r])?.[0];
+const MODS_REGISTRATION_REFUSED_NOTICE_CODE = 'mods.registration_refused';
+export function readModRegistrationRefusedNotice(ev) {
+    try {
+        if (!isCardRecordObject(ev))
+            return undefined;
+        if (readOwnDataValue(ev, 'code') !== MODS_REGISTRATION_REFUSED_NOTICE_CODE)
+            return undefined;
+        const row = modRowOf(readOwnDataValue(ev, 'detail'));
+        return row !== undefined && 'refusedBy' in row ? row : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+const MOD_NAME_SHOWN_MAX = 64;
+const MOD_REASON_SHOWN_MAX = 160;
+const shownName = (s) => displayUntrusted(s, { blanks: true, max: MOD_NAME_SHOWN_MAX });
+const shownReason = (s) => displayUntrusted(s, { max: MOD_REASON_SHOWN_MAX });
+export function modCardSentence(input, lang) {
+    try {
+        if (!isCardRecordObject(input))
+            return undefined;
+        if (toolResultBlockOf(input) !== undefined) {
+            const by = readOwnDataNonEmptyString(input, '_sema_answered_by');
+            if (by === undefined)
+                return undefined;
+            const gate = gateOutcomeOf({ gate: readOwnDataValue(input, '_sema_gate') });
+            return isDeniedGate(gate)
+                ? renderMessage(msg('config.mods.refusal.by', { by: shownName(by) }), lang)
+                : renderMessage(msg('config.mods.rewrite.resultInPlace', { by: shownName(by) }), lang);
+        }
+        const row = modRowOf(input);
+        if (row === undefined)
+            return undefined;
+        if ('refusedBy' in row) {
+            return renderMessage(msg('config.mods.card.refused', { name: shownName(row.name), refusedBy: shownName(row.refusedBy), reason: shownReason(row.reason) }), lang);
+        }
+        return renderMessage(msg('config.mods.card.mounted', { name: shownName(row.name) }), lang);
+    }
+    catch {
+        return undefined;
+    }
+}
+export function modLoaderFailureSentence(name, error, lang) {
+    const shown = guardedRead(() => (typeof name === 'string' ? shownName(name) : undefined)) ?? '';
+    const { reason } = wireFailureTextsOf(error);
+    if (reason === WIRE_FAILURE_UNRENDERABLE_TEXT)
+        return renderMessage(msg('config.mods.loader.failedNoReason', { name: shown }), lang);
+    return renderMessage(msg('config.mods.loader.failed', { name: shown, reason: shownReason(reason) }), lang);
+}

package/dist/ownKey.d.ts

@@ -6,6 +6,7 @@ export declare function readOwnDataFiniteNumber(v: object | null | undefined, ke
 export declare function readOwnDataValue<T>(v: object | null | undefined, key: string): T | undefined;
 export declare function carriesAnswerText(text: string): boolean;
 export declare function appendOwnElement<T>(list: T[], value: T): void;
+export declare function toolResultBlockOf(record: object): object | undefined;
 export declare function guardedRead<T>(read: () => T | undefined): T | undefined;
 export declare function ownDataField(v: object, key: string): unknown;
 export declare function ownSendableField(v: object, key: string): unknown;

package/dist/ownKey.js

@@ -40,6 +40,21 @@ export function carriesAnswerText(text) {
 export function appendOwnElement(list, value) {
     Object.defineProperty(list, list.length, { value, writable: true, enumerable: true, configurable: true });
 }
+export function toolResultBlockOf(record) {
+    const isRecord = (v) => typeof v === 'object' && v !== null && !Array.isArray(v);
+    const message = ownDataField(record, 'message');
+    if (!isRecord(message))
+        return undefined;
+    const content = ownDataField(message, 'content');
+    if (!Array.isArray(content))
+        return undefined;
+    for (let i = 0; i < content.length; i++) {
+        const block = ownDataField(content, String(i));
+        if (isRecord(block) && ownDataField(block, 'type') === 'tool_result')
+            return block;
+    }
+    return undefined;
+}
 export function guardedRead(read) {
     try {
         return read();

package/dist/printToolResultFrame.js

@@ -41,7 +41,7 @@ export function toolEndResultToUserFrame(arm) {
         parent_tool_use_id: parent,
         ...(isCcToolDenialKind(arm._sema_denial_kind) ? { _sema_denial_kind: arm._sema_denial_kind } : {}),
         ...(gateView !== undefined ? { _sema_gate: gateView } : {}),
-        ...toolResultRowFlagParts(arm),
+        ...toolResultRowFlagParts(arm, gateView),
         ...(Object.hasOwn(envelope, 'tool_use_result') ? { tool_use_result: envelope.tool_use_result } : {}),
         ...(Object.hasOwn(envelope, '_sema_degraded') ? { _sema_degraded: envelope._sema_degraded } : {}),
         uuid: rowIdentity.uuid,

package/dist/request/printNotification.js

@@ -16,7 +16,7 @@ export const PRINT_NOTIFICATION_FIELD_MATRIX = [
     { field: '_sema_partial', from: 'partial', cc: false, why: 'server 1.258:被终止子代的残果(消费方须渲成不完整,不得当完整结果)' },
     { field: '_sema_exit_code', from: 'exitCode', cc: false, why: '后台 bash 退出码(137=OOM 这类归因只在这一位上)' },
     { field: '_sema_diagnostics', from: 'diagnostics', cc: false, why: '引擎侧诊断串(UNTRUSTED,service 已 redact)' },
-    { field: '_sema_result', from: 'result', cc: false, why: '完成结果正文(#49 C1:帧带 result 必入 XML,print 出口同理不得独漏)' },
+    { field: '_sema_result', from: 'result', cc: false, why: '完成结果正文(帧带 result 必入 XML,print 出口同理不得独漏)' },
     { field: '_sema_lines', from: 'lines', cc: false, why: '尾部输出行(UNTRUSTED);交互面折进 <output-lines>' },
     { field: '_sema_recent_steps', from: 'recentSteps', cc: false, why: '结构化残局步骤 {tool,target,outcome}[] —— **原样透传**,不降级成交互面那份显示串(SDK 消费方要结构)' },
     { field: '_sema_edited_files', from: 'editedFiles', cc: false, why: '结构化改档清单 {path,edits}[];同上原样透传' },

package/dist/request/taskRequest.d.ts

@@ -1,4 +1,5 @@
 import type { TaskRequest, UserAttachment } from '@sema-agent/sdk';
+import { type ThinkingLatchState } from '../thinkingLatchWords.js';
 import { type ApprovalFrameFamiliesReading, type ApprovalFrameFamiliesWithheld } from '../approvalFrameFamilies.js';
 import { type OutputStyleSeatReading } from '../outputStyleSeatCapability.js';
 import { type ApprovalReachWord } from '../approvalReachWire.js';
@@ -66,6 +67,8 @@ export interface TaskRequestInput {
     repo?: string;
     hostSettings: HostTurnSettings;
     approvalFrameFamiliesReading?: ApprovalFrameFamiliesReading;
+    thinkingLatch?: 'on' | 'off';
+    reasoningFloor?: string;
     settings?: {
         ultracode?: boolean;
     };
@@ -84,6 +87,23 @@ export interface TaskRequestAssembly {
     readonly omitted: readonly TaskRequestOmission[];
     readonly host: HostTurnSettings;
     readonly approvalFrameFamiliesWithheld?: ApprovalFrameFamiliesWithheld;
+    readonly thinking: ThinkingTurnProjection;
+}
+export interface ThinkingTurnInput {
+    readonly submission: RequestLane | SubmissionIdentity;
+    readonly live: boolean;
+    readonly latch?: 'on' | 'off';
+    readonly strength?: unknown;
+    readonly floor?: string;
+    readonly ultracode?: boolean;
+}
+export interface ThinkingTurnProjection {
+    readonly word?: unknown;
+    readonly verdict: 'utility_lane' | 'off' | 'strength';
+    readonly latch: ThinkingLatchState;
+    readonly ultracodeStamped: boolean;
+    readonly floorApplied?: true;
+    readonly strengthOverruled?: unknown;
 }
 export type TaskRequestSeatReading = {
     readonly seat: 'seated';
@@ -136,6 +156,7 @@ export type MaxCostUsdParse = {
 export declare function parseMaxCostUsd(text: unknown): MaxCostUsdParse;
 export declare function assembleTaskRequest(input: TaskRequestInput, laneOrIdentity: RequestLane | SubmissionIdentity): TaskRequestAssembly;
 export declare function buildTaskRequest(input: TaskRequestInput, laneOrIdentity: RequestLane | SubmissionIdentity): TaskRequestLike;
+export declare function thinkingTurnProjection(input: ThinkingTurnInput): ThinkingTurnProjection;
 export interface LiveDefaultsInput {
     cwd?: string;
     additionalDirectories?: readonly string[];