@sema-agent/client-core 0.91.0 → 0.93.0

package/dist/adapt/arms.js

@@ -8,7 +8,7 @@ import { projectDiagnosticsFrame } from '../diagnostics.js';
 import { recordEngineToolLabel } from '../engineToolLabelStore.js';
 import { registerSubagentAlias, registerSubagentContentAlias } from '../subagentContentStore.js';
 import { readAsyncLaunchedAgentReceipt } from '../toolResult.js';
-import { isWorkflowAgentTaskId, recordWorkflowAgentTaskId } from '../workflow.js';
+import { recordWorkflowAgentTaskId } from '../workflow.js';
 import { isTerminalStatus } from '../runTerminal.js';
 import { readToolHistoryMismatchKey } from '../toolHistoryMismatch.js';
 import { readProviderRejectionResendKey } from '../providerRejection.js';
@@ -578,9 +578,7 @@ const taskProgressArm = function* (m, { ctx, cards, panel, inst }) {
     const explicitParentRaw = m.parentToolCallId;
     const explicitParent = typeof explicitParentRaw === 'string' ? explicitParentRaw : undefined;
     const workflowRunId = typeof m.workflowRunId === 'string' ? m.workflowRunId : undefined;
-    if (workflowRunId !== undefined ||
-        isWorkflowAgentTaskId(taskId) ||
-        (explicitParent !== undefined && inst.isWorkflowCard(explicitParent))) {
+    if (workflowRunId !== undefined) {
         recordWorkflowAgentTaskId(taskId);
         if (workflowRunId !== undefined && explicitParent !== undefined && inst.isWorkflowCard(explicitParent))
             noteOwnWorkflowRun(workflowRunId);
@@ -588,19 +586,13 @@ const taskProgressArm = function* (m, { ctx, cards, panel, inst }) {
             t: ctx.now(),
             taskId,
             lane: 'workflow',
-            via: workflowRunId !== undefined
-                ? 'workflowRunId'
-                : isWorkflowAgentTaskId(taskId)
-                    ? 'wa-id'
-                    : 'workflow-card-parent',
+            via: 'workflowRunId',
         }));
         return;
     }
     if (explicitParent !== undefined)
         registerSubagentAlias(explicitParent, taskId);
-    const cardId = explicitParent === undefined && !panel.isBound(taskId) && panel.unboundCandidates() > 1
-        ? undefined
-        : panel.bind(taskId, explicitParent);
+    const cardId = panel.bind(taskId, explicitParent);
     const usage = (m.usage ?? {});
     ctx.probe?.('tick', JSON.stringify({
         t: ctx.now(),
@@ -612,6 +604,7 @@ const taskProgressArm = function* (m, { ctx, cards, panel, inst }) {
         toolUses: usage.toolUses ?? null,
     }));
     const currentAction = typeof m.currentAction === 'string' && m.currentAction.length > 0 ? m.currentAction : undefined;
+    const model = typeof m.model === 'string' && m.model.length > 0 ? m.model : undefined;
     const spawnName = m.spawnName;
     if (cardId !== undefined) {
         yield chrome({
@@ -624,6 +617,7 @@ const taskProgressArm = function* (m, { ctx, cards, panel, inst }) {
                 totalTokens: typeof usage.totalTokens === 'number' ? usage.totalTokens : 0,
                 durationMs: typeof usage.durationMs === 'number' ? usage.durationMs : 0,
                 ...(currentAction !== undefined ? { currentAction } : {}),
+                ...(model !== undefined ? { model } : {}),
             },
         });
     }

package/dist/adapt/panelTasks.d.ts

@@ -3,9 +3,7 @@ import type { AdapterInstanceLedger } from './instanceLedger.js';
 import type { OpenCardView } from './toolCards.js';
 export interface PanelTaskLedger {
     bind(taskId: string, parentToolCallId?: string): string | undefined;
-    unboundCandidates(): number;
     laneOf(taskId: string): LaneProof;
-    isBound(taskId: string): boolean;
     isLiveBound(taskId: string): boolean;
     isLive(taskId: string): boolean;
     markLive(taskId: string): void;

package/dist/adapt/panelTasks.js

@@ -21,44 +21,24 @@ export function createPanelTaskLedger(ctx, cards, inst) {
     };
     return {
         laneOf,
-        isBound: (taskId) => taskCardBinding.has(taskId),
         isLiveBound: (taskId) => liveBoundPanelTasks.has(taskId),
         bind(taskId, parentToolCallId) {
             const existing = taskCardBinding.get(taskId);
             if (existing !== undefined)
                 return existing;
-            let target;
-            if (parentToolCallId !== undefined) {
-                const named = cards.peek(parentToolCallId);
-                if (named !== undefined && !SUBAGENT_TOOL_NAMES.has(named.name))
-                    return undefined;
-                target = parentToolCallId;
-            }
-            else {
-                for (const [id, p] of cards.entries()) {
-                    if (!boundToolCalls.has(id) && SUBAGENT_TOOL_NAMES.has(p.name)) {
-                        target = id;
-                        break;
-                    }
-                }
-            }
-            if (target === undefined)
+            if (parentToolCallId === undefined)
                 return undefined;
+            const named = cards.peek(parentToolCallId);
+            if (named !== undefined && !SUBAGENT_TOOL_NAMES.has(named.name))
+                return undefined;
+            const target = parentToolCallId;
             taskCardBinding.set(taskId, target);
             boundToolCalls.add(target);
             if (cards.has(target))
                 liveBoundPanelTasks.add(taskId);
-            ctx.probe?.('bind', `bind ${taskId} -> ${target} via=${parentToolCallId !== undefined ? 'explicit' : 'fifo'}`);
+            ctx.probe?.('bind', `bind ${taskId} -> ${target} via=explicit`);
             return target;
         },
-        unboundCandidates() {
-            let n = 0;
-            for (const [id, p] of cards.entries()) {
-                if (!boundToolCalls.has(id) && SUBAGENT_TOOL_NAMES.has(p.name))
-                    n++;
-            }
-            return n;
-        },
         isLive: (taskId) => livePanelTasks.has(taskId),
         markLive: (taskId) => {
             livePanelTasks.add(taskId);

package/dist/adapt/toolCards.js

@@ -1,5 +1,5 @@
 import { deriveTranscriptId } from '../seam.js';
-import { degradedToolResultBody, detectEngineBgShellReceipt, reportFindingsToolUseResult, structuredToToolUseResult, todoWriteToolUseResult, wireOutputToBody, } from '../toolResult.js';
+import { degradedToolResultBody, detectEngineBgShellDetach, detectEngineBgShellReceipt, reportFindingsToolUseResult, structuredToToolUseResult, todoWriteToolUseResult, wireOutputToBody, } from '../toolResult.js';
 import { chrome, mainLane, transcript } from './ids.js';
 import { flattenWireOutput } from './wireShapes.js';
 import { isCcToolDenialKind } from '../gateVocabulary.js';
@@ -34,9 +34,11 @@ export function createToolCardLedger(ctx, idOf) {
     let lastLiveTodos = [];
     function* buildToolResult(p, end) {
         const isError = end?.isError ?? false;
-        if ((p.name === 'Bash' || p.name === 'Monitor') && !isError && end?.output !== undefined) {
-            const reg = detectEngineBgShellReceipt(p.name, p.rawInput, flattenWireOutput(end.output));
-            if (reg) {
+        if ((p.name === 'Bash' || p.name === 'Monitor') && !isError) {
+            const outputText = end?.output !== undefined ? flattenWireOutput(end.output) : undefined;
+            const reg = detectEngineBgShellDetach(p.name, p.rawInput, end?.structured, outputText) ??
+                detectEngineBgShellReceipt(p.name, p.rawInput, outputText, end?.structured);
+            if (reg !== null) {
                 yield chrome({ kind: 'bgshell_register', laneProof: mainLane(), taskId: reg.taskId, registration: reg });
             }
         }

package/dist/adapt.d.ts

@@ -11,7 +11,7 @@ export declare const ADAPTER_COVERAGE: {
     readonly transcriptKinds: readonly ["assistant_text", "assistant_thinking", "assistant_tool_use", "user_tool_result_decision", "user_task_notification", "system_passthrough"];
     readonly b3: readonly ["T38 三清第三清 + T57 第五处断闸:prompt_suggestions(turn 开场作废 + 子流断闸)", "T40 IDLE-FLUSH 1.5s 竞速(需 ctx.setTimer;缺席=不启用)", "T58 手动 iterator 的 finally cleanup(early break/throw 都要关上游生成器)", "T59 abort 半场(ctx.signal;中断后不产终答)", "T60 无 result 收尾腿(泄尾增量 → 清 liveness → 尾思考 → 尾文本段)"];
     readonly b4: readonly ["A 层第 14 臂 task_progress:workflow lane 三级门 + 判据④ belt 回植 + C1 alias + bindTaskCard(显式父/FIFO/含糊即 unbound)+ inline stats + T50 双形读 + SubagentStart + #6 resident 台账 + 面板 tick", "settlePanelTasks 三处 sweep 全接线(tool_end 显式关卡带报告 / result 防御 sweep / turn 末 + abort sweep)", "P0-2 tool label 侧信道(sanitizeToolUseBlock 摘 label + engineToolLabelStore 登记;0.5.0 真缺口,label 会随 tool_use block 落转录 → /compact 直发 provider 400)", "task_notification 的两件宿主义务收回库内自持:dropQueuedNotificationsForRun + clearEnginePanelTaskResident;stop hook 的 if-started 门由库解", "T8 flattenWireOutput 提为独立导出(A 层 settle 报告与 B 层卡体同一份)"];
-    readonly b5: readonly ["B 层 structuredToToolUseResult 14 case(ask-user-question/bash/edit/create/update/text/grep/glob/notebook-edit/cron-create/cron-delete/cron-list/agent/task-output)+ workflow-run 登记副作用", "D 层 wireOutputToBody 3 臂(bash / taskoutput / 泛化);structured 白名单在场时 T11+T14 正则退位,缺席保回落", "E 层 4 臂:#117a bg Bash 回执 + #158 Monitor 回执(同臂按工具名分,registration.source 判别;判定在库→chrome bgshell_register)· TodoWrite oldTodos 富卡 · ReportFindings 按名认领 · Remember→memory_saved 系统消息", "tool_end_result → user tool_result 正常路径(卡本体);result 与 turn 末两处开卡兜底关闭(abort 不兜底,cli 同)", "task/task-list structured → chrome task_ledger_sync{source:\"structured\"}(判定归一在库、落盘留宿主)", "T7 诚实缺席(§8-4:不搬 mock 合成器,改 degraded 标记)· T20 diff hunks 进包(src/diff/patch.ts)"];
+    readonly b5: readonly ["B 层 structuredToToolUseResult 14 case(ask-user-question/bash/edit/create/update/text/grep/glob/notebook-edit/cron-create/cron-delete/cron-list/agent/task-output)+ workflow-run 登记副作用", "D 层 wireOutputToBody 3 臂(bash / taskoutput / 泛化);structured 白名单在场时 T11+T14 正则退位,缺席保回落", "E 层 4 臂:#117a bg Bash 回执 + #158 Monitor 回执(同臂按工具名分,registration.source 判别;判定在库→chrome bgshell_register)+ CC-331 交出后台的 Bash(结构化 detached 位同形登记,一张卡至多一条;结构化位自述登记失败时两臂都不铸)· TodoWrite oldTodos 富卡 · ReportFindings 按名认领 · Remember→memory_saved 系统消息", "tool_end_result → user tool_result 正常路径(卡本体);result 与 turn 末两处开卡兜底关闭(abort 不兜底,cli 同)", "task/task-list structured → chrome task_ledger_sync{source:\"structured\"}(判定归一在库、落盘留宿主)", "T7 诚实缺席(§8-4:不搬 mock 合成器,改 degraded 标记)· T20 diff hunks 进包(src/diff/patch.ts)"];
     readonly todo: readonly ["T13 的 **D 层** 半场(taskoutput block content)未随 structured 退位:退位会改 block content 形状(cli 那里是裸对象 = 件1 隐患),属行为面改动,无真实需求驱动 ⇒ 见 DIVERGENCE-8", "macrotask 让渡(cli 在提交前让出宏任务给 Ink;宿主渲染策略,不进库)"];
 };
 export declare const ADAPTER_DIVERGENCES: readonly [string, string, string, string, string, string, string, string, string, string, string, string];

package/dist/adapt.js

@@ -55,7 +55,7 @@ export const ADAPTER_COVERAGE = {
     b5: [
         'B 层 structuredToToolUseResult 14 case(ask-user-question/bash/edit/create/update/text/grep/glob/notebook-edit/cron-create/cron-delete/cron-list/agent/task-output)+ workflow-run 登记副作用',
         'D 层 wireOutputToBody 3 臂(bash / taskoutput / 泛化);structured 白名单在场时 T11+T14 正则退位,缺席保回落',
-        'E 层 4 臂:#117a bg Bash 回执 + #158 Monitor 回执(同臂按工具名分,registration.source 判别;判定在库→chrome bgshell_register)· TodoWrite oldTodos 富卡 · ReportFindings 按名认领 · Remember→memory_saved 系统消息',
+        'E 层 4 臂:#117a bg Bash 回执 + #158 Monitor 回执(同臂按工具名分,registration.source 判别;判定在库→chrome bgshell_register)+ CC-331 交出后台的 Bash(结构化 detached 位同形登记,一张卡至多一条;结构化位自述登记失败时两臂都不铸)· TodoWrite oldTodos 富卡 · ReportFindings 按名认领 · Remember→memory_saved 系统消息',
         'tool_end_result → user tool_result 正常路径(卡本体);result 与 turn 末两处开卡兜底关闭(abort 不兜底,cli 同)',
         'task/task-list structured → chrome task_ledger_sync{source:"structured"}(判定归一在库、落盘留宿主)',
         'T7 诚实缺席(§8-4:不搬 mock 合成器,改 degraded 标记)· T20 diff hunks 进包(src/diff/patch.ts)',
@@ -107,10 +107,10 @@ export const ADAPTER_DIVERGENCES = [
         '(0.81.0–0.82.x 曾与 CC 内部转录面驼峰 `toolUseResult` 同引用并铸,0.83.0 删驼峰);cli 侧仍带驼峰 —— 所钉的本包' +
         '旧版本两键同铸,升级后在转录入口从 `tool_use_result` 同值起别名。守卫在两键同在场且同引用时略过驼峰键、' +
         '按 snake 比(两侧对称);cli 侧不再带驼峰后本条自然零触发 ⇒ 自退役。',
-    'DIVERGENCE-11(0.83.0,C-R103):system 转录行的到达时戳 —— 本包只给 user / assistant 行补 `timestamp`' +
+    'DIVERGENCE-11(0.83.0):system 转录行的到达时戳 —— 本包只给 user / assistant 行补 `timestamp`' +
         '(agent-types 只在这两臂声明),system 行不补(入参自带的照旧原样过境);壳的接收口给每条转录行补到达时刻(只补缺席)。' +
         '守卫在逐字比对前只从壳侧 system 行上去掉这一位;本包侧 system 行若带 `timestamp`,照样判不等。',
-    'DIVERGENCE-12(0.83.0,C-R103):记忆写入 —— 本包发 chrome `memory_saved` 臂(`notes` = 笔记原文,`id` 由这次写入的 wire ' +
+    'DIVERGENCE-12(0.83.0):记忆写入 —— 本包发 chrome `memory_saved` 臂(`notes` = 笔记原文,`id` 由这次写入的 wire ' +
         '稳定键派生),转录面零行;壳侧是一条 system/memory_saved 转录行(`writtenPaths` 装同一份笔记)。守卫把壳侧这类行移出逐字比对,' +
         '改比:事件 `notes` ⇔ 行 `writtenPaths` 逐项相等、位置相等(之前已覆盖转录行的条数);`id` 不与旧行 uuid 比(本版不承诺相等)。',
 ];

package/dist/adapter/activeRunSelfHeal.d.ts

@@ -192,8 +192,6 @@ export interface SelfHealFollowDeclaration {
 }
 export declare function readCancelRequested(body: unknown): boolean | undefined;
 export declare function atMostOnceFailureClass(e: unknown): 'rejected' | 'unknown';
-export declare function readSteerDelivery(receipt: unknown): string | null;
-export declare function readSteerReceiptStatus(receipt: unknown): string | null;
 export declare function clearRunningChoiceOffer(taskId: string, sessionId?: string): void;
 export declare function __resetRunningChoiceLedgerForTests(): void;
 export interface ClaimReleaseVerdict {

package/dist/adapter/activeRunSelfHeal.js

@@ -1,6 +1,7 @@
 import { abortableSleep } from '../abortableSleep.js';
 import { corruptStoredRowContent, corruptStoredRowWhere, effectiveWireErrorCode } from '../wireErrorTriage.js';
-import { steeringRefusedBeforeEngine, steeringStatusIs4xx } from '../controlRouter.js';
+import { steerBodyOf, steeringRefusedBeforeEngine, steeringStatusIs4xx, UNOBSERVED_STEER_PRIORITY } from '../controlRouter.js';
+import { readSteerReceipt } from '../steerReceipt.js';
 export const PLAN_REVIEW_GATE_KIND = 'plan_review';
 export const PLAN_REVIEW_GATE_KINDS = Object.freeze([PLAN_REVIEW_GATE_KIND, 'dry_run_review']);
 export const ASK_PARK_GATE_KINDS = Object.freeze(['human', 'irreversible_ask', 'policy_ask', 'tool_approval']);
@@ -265,28 +266,6 @@ export function atMostOnceFailureClass(e) {
         return 'rejected';
     return typeof e === 'object' && e !== null && steeringRefusedBeforeEngine(e) !== undefined ? 'rejected' : 'unknown';
 }
-export function readSteerDelivery(receipt) {
-    try {
-        if (typeof receipt !== 'object' || receipt === null || !('delivery' in receipt))
-            return null;
-        const d = receipt.delivery;
-        return typeof d === 'string' && d.length > 0 ? d : null;
-    }
-    catch {
-        return null;
-    }
-}
-export function readSteerReceiptStatus(receipt) {
-    try {
-        if (typeof receipt !== 'object' || receipt === null || !('status' in receipt))
-            return null;
-        const s = receipt.status;
-        return typeof s === 'string' && s.length > 0 ? s : null;
-    }
-    catch {
-        return null;
-    }
-}
 const CANCEL_RELEASE_WAIT_MS = 10_000;
 const RUNNING_LIVENESS_RECHECK_TIMEOUT_MS = 4_000;
 const runningChoiceDeclined = new Set();
@@ -772,9 +751,8 @@ async function runningChoiceArm(taskId, status, busy, statusFromWire, runs, deps
     }
     if (choice === 'steer' && canSteer && runs?.steer !== undefined) {
         try {
-            const receipt = await runs.steer(taskId, { text }, sessionOpts(deps));
-            const delivery = readSteerDelivery(receipt);
-            const receiptStatus = readSteerReceiptStatus(receipt);
+            const receipt = await runs.steer(taskId, steerBodyOf({ text }, UNOBSERVED_STEER_PRIORITY), sessionOpts(deps));
+            const { delivery, status: receiptStatus } = readSteerReceipt(receipt);
             if (delivery === 'queued') {
                 const verdict = receiptStatus !== null && PLAN_REVIEW_STATES.includes(receiptStatus)
                     ? await planVerdict(taskId, deps)
@@ -1071,7 +1049,7 @@ function activeRunSelfHealBaseRow(outcome, signal, wayOut, following = false, ke
         }
         case 'running-steer-failed':
             if (outcome.delivery === 'rejected') {
-                return (`The engine rejected handing your message to the running run (run ${outcome.taskId}): ${outcome.detail}. ` +
+                return (`Handing your message to the running run (run ${outcome.taskId}) was refused: ${outcome.detail}. ` +
                     `sema did NOT retry it (a steer is not safe to send twice) and it did NOT cancel that run. ` +
                     `Your message was NOT sent; send it again if you still want it.`);
             }

package/dist/adapter/downstream/terminalToSdkResult.js

@@ -7,8 +7,15 @@ import { isReviewPark, readRunTerminal, runTerminalCode, runTerminalGateToolName
 import { toCcModelUsage } from './turnUsageToModelUsage.js';
 import { LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, OUTPUT_INVALID, isCorruptSessionCode, isRewindFamilyCode, } from '../../engineErrorCodes.js';
 import { corruptSessionContent } from '../../corruptSessionCopy.js';
-function withSessionUnreadableNote(text, code) {
-    return isCorruptSessionCode(code) ? `${text}\n${corruptSessionContent()}` : text;
+import { abortCauseNoteOf, readAbortCause } from '../../runCancelContext.js';
+function withTerminalNote(text, code, frame) {
+    const withCorrupt = isCorruptSessionCode(code) ? `${text}\n${corruptSessionContent()}` : text;
+    const abortNote = abortCauseNoteOf(frame);
+    return abortNote === undefined ? withCorrupt : `${withCorrupt}\n${abortNote}`;
+}
+function abortCauseWordOf(frame) {
+    const r = readAbortCause(frame);
+    return r === undefined ? undefined : r.kind === 'known' ? r.cause : r.word;
 }
 function finiteOr0(v) {
     return typeof v === 'number' && Number.isFinite(v) ? v : 0;
@@ -500,6 +507,7 @@ function errorResult(ctx, parts) {
         ...(parts.salvagedResult !== undefined ? { _sema_salvaged_result: parts.salvagedResult } : {}),
         ...(parts.outcomeUnknown === true ? { _sema_outcome: 'unknown' } : {}),
         ...(parts.parkFailedReason !== undefined ? { _sema_park_failed_reason: washCredentials(parts.parkFailedReason) } : {}),
+        ...(parts.abortCause !== undefined ? { _sema_abort_cause: parts.abortCause } : {}),
     });
 }
 export function doneToSdkResult(ev, ctx, observed) {
@@ -516,7 +524,7 @@ export function doneToSdkResult(ev, ctx, observed) {
     const degraded = degradedOf(r);
     const parkFailedRaw = ev._sema_park_failed_reason;
     const parkFailedReason = typeof parkFailedRaw === 'string' && parkFailedRaw.length > 0 ? parkFailedRaw : undefined;
-    const errorBase = { durationMs, stats, model: r.model, errorCode, degraded, observed, facts: effectiveFactParts(rec), parkFailedReason };
+    const errorBase = { durationMs, stats, model: r.model, errorCode, degraded, observed, facts: effectiveFactParts(rec), parkFailedReason, abortCause: abortCauseWordOf(ev) };
     if (terminal?.kind === 'failed') {
         const failedCode = terminal.code;
         const failedMessage = terminal.message;
@@ -534,9 +542,9 @@ export function doneToSdkResult(ev, ctx, observed) {
             ...errorBase,
             subtype: failedSubtype,
             errors: [
-                withSessionUnreadableNote(isRewindFamilyCode(failedCode) && failedMessage
+                withTerminalNote(isRewindFamilyCode(failedCode) && failedMessage
                     ? `${failedMessage} (${failedCode})`
-                    : (failedMessage ?? 'run failed'), failedCode),
+                    : (failedMessage ?? 'run failed'), failedCode, ev),
             ],
         });
     }
@@ -625,10 +633,11 @@ export function failedToSdkResult(ev, ctx, observed) {
         observed,
         durationMs: elapsedMs(ctx),
         errorCode: ev.errorCode,
+        abortCause: abortCauseWordOf(ev),
         errors: [
-            withSessionUnreadableNote(isRewindFamilyCode(ev.errorCode) && ev.errorMessage
+            withTerminalNote(isRewindFamilyCode(ev.errorCode) && ev.errorMessage
                 ? `${ev.errorMessage} (${ev.errorCode})`
-                : (ev.errorMessage ?? ev.errorCode ?? 'run failed'), ev.errorCode),
+                : (ev.errorMessage ?? ev.errorCode ?? 'run failed'), ev.errorCode, ev),
         ],
     });
 }

package/dist/adapter/runStream.js

@@ -5,6 +5,7 @@ import { readRunCostFacts, terminalToSdkResult, TOOL_INPUT_JOIN_MAX_CALLS } from
 import { coerceOutput, publishSubagentContentEvent } from '../subagentContentStore.js';
 import { ACTIVE_RUN_BUSY_ERROR_CODE, OUTPUT_INVALID, isCorruptSessionCode, isLimitsExceededCode } from '../engineErrorCodes.js';
 import { corruptSessionContent } from '../corruptSessionCopy.js';
+import { abortCauseNoteOf } from '../runCancelContext.js';
 import { classifyToolHistoryMismatch, noteToolHistoryTerminal, openToolHistoryGeneration, TOOL_HISTORY_REWIND_SENTENCE, toolHistoryMismatchRowKey, toolHistoryRepeatSentence, toolHistoryRewindOffered, } from '../toolHistoryMismatch.js';
 import { isReviewPark, readRunTerminal, runTerminalCode } from '../runTerminal.js';
 import { providerRejectionResend } from '../providerRejection.js';
@@ -328,8 +329,10 @@ const DROPPED_WHY_SENTENCE = Object.freeze({
         'If the engine reuses an id across two DIFFERENT frames (server 7.77.0 does this for `reasoning_end`, fixed upstream in 7.78.1), the second one is lost here — this line is the only trace.',
     turn_end_usage_absent: "the engine declares `turn_end.usage` as always present (core >= 7.17.0), and this frame has none. " +
         'The turn is counted as UNKNOWN spend (the run total is reported as a lower bound), and the frame itself renders NOWHERE.',
+    unknown_arm: "this build's projector has no arm for this frame type, so it was dropped — the type is not one this build knows (an engine newer than this client can send such frames). It renders NOWHERE.",
+    malformed: "this build's projector has an arm for this frame type, but the frame did not pass that arm's shape check (a field it requires was not usable), so it was dropped. It renders NOWHERE.",
 });
-const DROPPED_WHY_SENTENCE_DEFAULT = "this build's projector has no arm for it (engine newer than the client, or a malformed frame). It renders NOWHERE.";
+const DROPPED_WHY_SENTENCE_DEFAULT = "this build's projector has no arm for it (engine newer than the client, or a malformed frame; this build cannot tell which). It renders NOWHERE.";
 export function droppedWhySentence(why) {
     const row = Object.hasOwn(DROPPED_WHY_SENTENCE, why) ? DROPPED_WHY_SENTENCE[why] : undefined;
     return typeof row === 'string' ? row : DROPPED_WHY_SENTENCE_DEFAULT;
@@ -660,6 +663,7 @@ async function* runStreamInner(events, ctx, handle = {}) {
                 const sessionUnreadable = ev.type === 'failed'
                     ? isCorruptSessionCode(ev.errorCode)
                     : doneTerminal?.kind === 'failed' && isCorruptSessionCode(doneTerminal.code);
+                const abortNote = abortCauseNoteOf(ev);
                 const historyTerminal = apiErrorTerminalOfRowFrame(ev, rowFacts);
                 const historyMismatch = classifyToolHistoryMismatch(historyTerminal.carrier);
                 const historyEchoedSid = ev.type === 'done' ? engineSessionIdOf(ev.result) : undefined;
@@ -677,7 +681,7 @@ async function* runStreamInner(events, ctx, handle = {}) {
                     : '';
                 const resend = historyTerminal.detail !== undefined ? providerRejectionResend(historyTerminal.detail, historyTerminal.carrier) : undefined;
                 const resendLine = resend !== undefined ? `\n${resend.text}` : '';
-                yield syntheticTerminalRow(ctx, `${sessionUnreadable ? `${rowText}\n${corruptSessionContent()}` : rowText}${rewindLine}${resendLine}`, historyMismatch === null ? undefined : toolHistoryMismatchRowKey(historyMismatch, historyRepeat, rewindOffered), resend);
+                yield syntheticTerminalRow(ctx, `${sessionUnreadable ? `${rowText}\n${corruptSessionContent()}` : rowText}${abortNote !== undefined ? `\n${abortNote}` : ''}${rewindLine}${resendLine}`, historyMismatch === null ? undefined : toolHistoryMismatchRowKey(historyMismatch, historyRepeat, rewindOffered), resend);
             }
             else {
                 const echoedSid = ev.type === 'done' ? engineSessionIdOf(ev.result) : undefined;

package/dist/agentsWireCaps.js

@@ -249,7 +249,7 @@ async function runPrepare(cfg, projector, probe, generation) {
         const [caps, projected] = await Promise.all([probe, projector()]);
         if (caps === false) {
             if (projected.agents && preparedKey === cfg.baseUrl) {
-                warnOnce(`agents wire: this engine does not support per-task custom agents (capabilities.taskAgents absent/false — server <1.205 or multi-tenant) — ${projected.agents.length} custom agent definition(s) will NOT be sent`);
+                warnOnce(`agents wire: this engine does not support per-task custom agents (capabilities.taskAgents is not true: the engine does not report it, or this deployment turns it off, for example a multi-tenant one; this client cannot tell which) — ${projected.agents.length} custom agent definition(s) will NOT be sent`);
             }
             return;
         }

package/dist/approvalDecidedByCapability.d.ts

@@ -0,0 +1,16 @@
+export type ApprovalDecidedByReading = {
+    kind: 'unobserved';
+} | {
+    kind: 'not_reported';
+} | {
+    kind: 'present';
+    value: true;
+};
+export declare function projectApprovalDecidedByCapability(caps: unknown): ApprovalDecidedByReading | undefined;
+export declare function noteEngineCapsForApprovalDecidedBy(baseUrl: string, caps: unknown, opts?: {
+    generation?: number;
+}): void;
+export declare function observedApprovalDecidedBy(baseUrl?: string | undefined): ApprovalDecidedByReading;
+export declare function approvalDecidedByAdmitted(reading: ApprovalDecidedByReading | undefined): boolean;
+export declare function forgetApprovalDecidedByReading(baseUrl: string | undefined): void;
+export declare function __resetApprovalDecidedByReadingsForTests(): void;

package/dist/approvalDecidedByCapability.js

@@ -0,0 +1,47 @@
+import { engineWireTarget } from './engineWireTarget.js';
+import { createEngineCapReader } from './engineCapReader.js';
+import { readOwnDataValue } from './ownKey.js';
+export function projectApprovalDecidedByCapability(caps) {
+    try {
+        if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
+            return undefined;
+        if (!Object.hasOwn(caps, 'approvalDecidedBy'))
+            return { kind: 'not_reported' };
+        const v = caps.approvalDecidedBy;
+        if (v === undefined)
+            return { kind: 'not_reported' };
+        return v === true ? { kind: 'present', value: true } : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+const reader = createEngineCapReader({
+    name: 'approvalDecidedBy',
+    project: projectApprovalDecidedByCapability,
+    makeUnobserved: () => ({ kind: 'unobserved' }),
+});
+export function noteEngineCapsForApprovalDecidedBy(baseUrl, caps, opts) {
+    reader.note(baseUrl, caps, opts);
+}
+export function observedApprovalDecidedBy(baseUrl = engineWireTarget()?.baseUrl) {
+    return reader.observed(baseUrl);
+}
+export function approvalDecidedByAdmitted(reading) {
+    try {
+        if (reading === null || reading === undefined || typeof reading !== 'object' || Array.isArray(reading))
+            return false;
+        if (readOwnDataValue(reading, 'kind') !== 'present')
+            return false;
+        return readOwnDataValue(reading, 'value') === true;
+    }
+    catch {
+        return false;
+    }
+}
+export function forgetApprovalDecidedByReading(baseUrl) {
+    reader.forget(baseUrl);
+}
+export function __resetApprovalDecidedByReadingsForTests() {
+    reader.__resetForTests();
+}

package/dist/approvalsStreamLiveCapability.js

@@ -31,13 +31,13 @@ export function livePendingNeedsReconcile(reading) {
 export function approvalsStreamLiveDoctorDetail(reading) {
     switch (reading.kind) {
         case 'unobserved':
-            return 'live approval push not observed — the engine reports it on /v1/capabilities; this process has no usable capabilities reading cached for it (none received, or the last one was unreadable), so suspended asks are pulled by the reconcile cadence';
+            return 'live approval push not observed — the engine reports it on /v1/capabilities; this process has no usable capabilities reading cached for it (none received, the last one was unreadable, or the last one was discarded when the engine connection was reset; this process cannot tell which), so suspended asks are pulled by the reconcile cadence';
         case 'not_reported':
-            return 'live approval push not reported by this engine — only newer engines advertise it; this does not say whether it pushes, so suspended asks are pulled by the reconcile cadence';
+            return 'live approval push not reported by this engine; this does not say whether it pushes, so suspended asks are pulled by the reconcile cadence';
         case 'present':
             return reading.live
                 ? 'live approval push on — the engine announces suspended asks on the approvals stream; the reconcile cadence is only a fallback'
-                : 'live approval push off on this deployment (no checkpoint store or tool approvals disabled) — suspended asks are only visible through the reconcile cadence, so the client polls for them';
+                : 'live approval push off on this deployment (no checkpoint store or tool approvals disabled; the engine reports one bit for both, so this client cannot tell which) — suspended asks are only visible through the reconcile cadence, so the client polls for them';
     }
 }
 export function forgetApprovalsStreamLiveReading(baseUrl) {

package/dist/askSurvivesStandingAnswer.d.ts

@@ -1,10 +1,13 @@
-export declare const MODE_ARBITRATION: Readonly<Record<"hook" | "write_protection" | "mode" | "rule_unreadable" | "content_question" | "ancestor" | "unverifiable_delete" | "transcript_write" | "org_rule" | "governance_unavailable" | "ask_rule" | "denial_limit_fallback" | "operator_forced" | "shell_floor" | "write_protection_unresolved" | "probe" | "tool_marks_mcp" | "tool_marks_a2a" | "policy_rra" | "artifact_shared_read" | "unstated" | "ordinary", import("./generated/engineFactTables.js").CoreModeArbitrationRow>>;
+import { type AutomaticAnswerRoad, type AutomaticAnswerUnknownWhy } from './hitl/automaticAnswerVerdict.js';
+export declare const MODE_ARBITRATION: Readonly<Record<"hook" | "write_protection" | "mode" | "rule_unreadable" | "content_question" | "ancestor" | "unverifiable_delete" | "transcript_write" | "org_rule" | "governance_unavailable" | "ask_rule" | "denial_limit_fallback" | "classifier_no_ruling" | "requires_user_interaction" | "operator_forced" | "shell_floor" | "write_protection_unresolved" | "probe" | "tool_marks_mcp" | "tool_marks_a2a" | "policy_rra" | "artifact_shared_read" | "unstated" | "ordinary", import("./generated/engineFactTables.js").CoreModeArbitrationRow>>;
 export type StandingAnswerVerdict = {
     readonly kind: 'must_ask';
     readonly by: string;
+    readonly road?: AutomaticAnswerRoad;
 } | {
     readonly kind: 'may_answer';
 } | {
     readonly kind: 'unknown';
+    readonly why?: AutomaticAnswerUnknownWhy;
 };
 export declare function askSurvivesStandingAnswer(card: object | null | undefined): StandingAnswerVerdict;

package/dist/askSurvivesStandingAnswer.js

@@ -1,9 +1,22 @@
 import { CORE_MODE_ARBITRATION } from './generated/engineFactTables.js';
+import { automaticAnswerVerdict } from './hitl/automaticAnswerVerdict.js';
 export const MODE_ARBITRATION = CORE_MODE_ARBITRATION;
 const MUST_ASK_MANDATED = Object.freeze({ kind: 'must_ask', by: 'mandated' });
 const MAY_ANSWER = Object.freeze({ kind: 'may_answer' });
 const UNKNOWN = Object.freeze({ kind: 'unknown' });
 export function askSurvivesStandingAnswer(card) {
+    const old = legacyStandingAnswerVerdict(card);
+    const neu = automaticAnswerVerdict(card, 'standing_rule');
+    if (old.kind === 'must_ask' || neu.kind === 'must_ask') {
+        const by = old.kind === 'must_ask' ? old.by : neu.kind === 'must_ask' ? (neu.askClass ?? neu.road) : 'mandated';
+        const road = neu.kind === 'must_ask' ? neu.road : by === 'mandated' ? 'mandated' : 'ask_class';
+        return Object.freeze({ kind: 'must_ask', by, road });
+    }
+    if (old.kind === 'unknown' || neu.kind === 'unknown')
+        return neu.kind === 'unknown' ? Object.freeze({ kind: 'unknown', why: neu.why }) : UNKNOWN;
+    return MAY_ANSWER;
+}
+function legacyStandingAnswerVerdict(card) {
     try {
         if (card === null || card === undefined || typeof card !== 'object')
             return UNKNOWN;

package/dist/autoModeUnavailable.js

@@ -1,4 +1,5 @@
-export const CLASSIFIER_DENY_CAUSES = Object.freeze(['unavailable', 'parse_error']);
+import { CORE_AUTO_MODE_UNAVAILABLE_CAUSES, CORE_CLASSIFIER_DENY_CAUSES } from './generated/engineFactTables.js';
+export const CLASSIFIER_DENY_CAUSES = CORE_CLASSIFIER_DENY_CAUSES;
 const DENY_CAUSE_SET = new Set(CLASSIFIER_DENY_CAUSES);
 export function isClassifierDenyCause(v) {
     return typeof v === 'string' && DENY_CAUSE_SET.has(v);
@@ -26,7 +27,7 @@ function gateRecordOf(v) {
         return undefined;
     return g;
 }
-export const AUTO_MODE_UNAVAILABLE_CAUSES = Object.freeze(['error', 'timeout']);
+export const AUTO_MODE_UNAVAILABLE_CAUSES = CORE_AUTO_MODE_UNAVAILABLE_CAUSES;
 const DENY_CAUSE_SENTENCES = Object.freeze({
     unavailable: 'denied because the auto-mode classifier could not run this round (the call may be retried later)',
     parse_error: 'denied because the auto-mode classifier answered outside its contract (its reply could not be parsed, so the call was blocked)',

package/dist/centerWiringCapability.js

@@ -159,7 +159,7 @@ export function centerWiringDoctorDetail(reading) {
     const unobserved = 'center wiring not observed — the engine reports it on /v1/capabilities; this process has no usable capabilities reading cached for it, so whether this engine is connected to a configuration center is unknown';
     const r = guarded(reading);
     if (r?.kind === 'not_reported') {
-        return 'center wiring not reported by this engine — only newer engines advertise it; this does not say whether the engine is connected to a configuration center';
+        return 'center wiring not reported by this engine; this does not say whether the engine is connected to a configuration center';
     }
     if (r?.kind === 'none') {
         return 'no configuration center on this deployment — the engine runs on its own local configuration; no quota lease or usage reporting goes through a center';

package/dist/cloudConfigWireCaps.js

@@ -1,6 +1,7 @@
 import { MCP_CAPS } from './mcpWireCaps.js';
 import { toCappedSpec } from './skillsWireCaps.js';
 import { TIER_ORDER } from './model/tierVocabulary.js';
+import { SETTINGS_BUDGET_NUMBER_KEYS, SETTINGS_BUDGET_PER_MODEL_NUMBER_KEYS, SETTINGS_BUDGET_STRING_KEYS, SETTINGS_TIER_GROUP_NAME_RE, } from './generated/settingsSchemaTables.js';
 const asRec = (v) => (typeof v === 'object' && v !== null && !Array.isArray(v) ? v : undefined);
 const asArr = (v) => (Array.isArray(v) ? v : []);
 const asStr = (v) => (typeof v === 'string' && v.length > 0 ? v : undefined);
@@ -129,7 +130,7 @@ function withoutRegistryAnnotations(e) {
     return out;
 }
 const TIER_WORDS = TIER_ORDER;
-const TIER_GROUP_NAME = /^[a-z0-9][a-z0-9._-]*$/i;
+const TIER_GROUP_NAME = SETTINGS_TIER_GROUP_NAME_RE;
 const setOwn = (o, k, v) => {
     Object.defineProperty(o, k, { value: v, enumerable: true, writable: true, configurable: true });
 };
@@ -319,9 +320,9 @@ export function cloudRosterNames(rostersValue) {
         .map((e) => asStr(asRec(e)?.name))
         .filter((n) => !!n);
 }
-const BUDGET_NUMBER_KEYS = ['maxBudgetUsd', 'tpmLimit', 'rpmLimit', 'maxParallelRequests', 'maxRunCostUsd', 'maxIterations'];
-const BUDGET_STRING_KEYS = ['mode', 'budgetDuration', 'enforcement'];
-const PER_MODEL_NUMBER_KEYS = ['maxBudgetUsd', 'tpmLimit', 'rpmLimit'];
+const BUDGET_NUMBER_KEYS = SETTINGS_BUDGET_NUMBER_KEYS;
+const BUDGET_STRING_KEYS = SETTINGS_BUDGET_STRING_KEYS;
+const PER_MODEL_NUMBER_KEYS = SETTINGS_BUDGET_PER_MODEL_NUMBER_KEYS;
 const _budgetKeysCovered = true;
 const _budgetKeysReal = true;
 const _perModelKeysCovered = true;
@@ -488,6 +489,8 @@ export function projectEffectiveBody(body, skillBodies, env, rostersValue, opts)
 }
 const quoted = (s, fallback) => (s === undefined ? fallback : `the "${s}" settings`);
 const listOf = (xs, truncatedFrom) => xs === undefined ? '' : `: ${xs.join(', ')}${truncatedFrom === undefined ? '' : ` (${truncatedFrom} in total)`}`;
+const ENTRY_UNUSABLE_WHY = '(incomplete or invalid settings; this client cannot tell which)';
+const ENTRY_REJECTED = `is in the catalog, but its entry is one the local engine cannot use ${ENTRY_UNUSABLE_WHY}`;
 function warningNotice(w) {
     const where = quoted(w.domain, 'the configuration');
     switch (w.kind) {
@@ -511,12 +514,10 @@ function warningNotice(w) {
 }
 function droppedRefNotice(d) {
     const t = d.target;
-    const notServed = d.reason === 'rejected'
-        ? 'is in the catalog, but its entry is one the local engine cannot use (incomplete or invalid settings)'
-        : 'is not in the model catalog served to you';
+    const notServed = d.reason === 'rejected' ? ENTRY_REJECTED : 'is not in the model catalog served to you';
     switch (d.key) {
         case 'models':
-            return { level: 'warn', text: `cloud config: ${t === undefined ? 'a model entry' : `model "${t}"`} is in the catalog, but its entry is one the local engine cannot use (incomplete or invalid settings) — it was left out of the local catalog` };
+            return { level: 'warn', text: `cloud config: ${t === undefined ? 'a model entry' : `model "${t}"`} ${ENTRY_REJECTED} — it was left out of the local catalog` };
         case 'default':
             return { level: 'warn', text: `cloud config: ${t === undefined ? 'the default model setting could not be read' : `the default model "${t}" ${notServed}`}, so it was left out — the local engine picks its default from roles and tiers instead` };
         case 'roles':
@@ -598,7 +599,7 @@ export function cloudEffectiveNotices(p) {
         const shown = named.slice(0, 5).join(', ') + (named.length > 5 ? `, +${named.length - 5} more` : '');
         out.push({
             level: 'warn',
-            text: `cloud config: none of the model entries served to you${shown !== '' ? ` (${shown})` : ''} is one the local engine can use (incomplete or invalid settings) — ` +
+            text: `cloud config: none of the model entries served to you${shown !== '' ? ` (${shown})` : ''} is one the local engine can use ${ENTRY_UNUSABLE_WHY} — ` +
                 'the catalog is kept as sent, and a locally started engine rejects the cloud model settings: at startup it uses its own environment catalog instead, and on a later refresh it keeps the previous configuration',
         });
     }