@sema-agent/client-core 0.97.1 → 0.99.0

package/dist/scenarioRefusal.js

@@ -0,0 +1,111 @@
+import { capForDisplay } from './fleetTaskDesc.js';
+import { readOwnDataValue } from './ownKey.js';
+import { SCENARIO_ASSIGNMENT_UNKNOWN_ERROR_CODE } from './engineErrorCodes.js';
+import { readErrorRecord, readErrorString } from './wireFailureShape.js';
+import { effectiveWireErrorCode } from './wireErrorTriage.js';
+const SCENARIO_REFUSAL_ERROR_MAX = 200;
+function detailBits(detail) {
+    if (detail === undefined)
+        return {};
+    let scenario;
+    let source;
+    try {
+        scenario = readOwnDataValue(detail, 'scenario');
+    }
+    catch {
+        scenario = undefined;
+    }
+    try {
+        source = readOwnDataValue(detail, 'source');
+    }
+    catch {
+        source = undefined;
+    }
+    return {
+        ...(typeof scenario === 'string' && scenario.length > 0 ? { scenario } : {}),
+        ...(source === 'ruling' || source === 'deployment' ? { source } : {}),
+    };
+}
+const isPlainRecord = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+export function scenarioRefusalOf(body) {
+    let raw;
+    try {
+        const d = Object.getOwnPropertyDescriptor(body, 'scenarioRefusal');
+        if (d === undefined)
+            return undefined;
+        raw = 'value' in d ? d.value : undefined;
+    }
+    catch {
+        return null;
+    }
+    try {
+        if (!isPlainRecord(raw))
+            return Object.freeze({});
+        const own = (key) => {
+            try {
+                return readOwnDataValue(raw, key);
+            }
+            catch {
+                return undefined;
+            }
+        };
+        const errorCode = own('errorCode');
+        const error = own('error');
+        const detail = own('detail');
+        let bits = {};
+        try {
+            bits = detailBits(isPlainRecord(detail) ? detail : undefined);
+        }
+        catch {
+            bits = {};
+        }
+        return Object.freeze({
+            ...(typeof errorCode === 'string' && errorCode.length > 0 ? { errorCode } : {}),
+            ...(typeof error === 'string' && error.length > 0 ? { error: capForDisplay(error, SCENARIO_REFUSAL_ERROR_MAX) } : {}),
+            ...bits,
+        });
+    }
+    catch {
+        return Object.freeze({});
+    }
+}
+export function scenarioRefusalFromError(err) {
+    try {
+        if (err === null || typeof err !== 'object')
+            return null;
+        if (effectiveWireErrorCode(err) !== SCENARIO_ASSIGNMENT_UNKNOWN_ERROR_CODE)
+            return null;
+        const error = readErrorString(err, 'message');
+        return Object.freeze({
+            errorCode: SCENARIO_ASSIGNMENT_UNKNOWN_ERROR_CODE,
+            ...(error !== undefined && error.length > 0 ? { error: capForDisplay(error, SCENARIO_REFUSAL_ERROR_MAX) } : {}),
+            ...detailBits(readErrorRecord(err, 'detail')),
+        });
+    }
+    catch {
+        return null;
+    }
+}
+export function scenarioRefusalContent(reading) {
+    let code;
+    let scenario;
+    let source;
+    try {
+        code = isPlainRecord(reading) ? readOwnDataValue(reading, 'errorCode') : undefined;
+        scenario = isPlainRecord(reading) ? readOwnDataValue(reading, 'scenario') : undefined;
+        source = isPlainRecord(reading) ? readOwnDataValue(reading, 'source') : undefined;
+    }
+    catch {
+        code = undefined;
+        scenario = undefined;
+        source = undefined;
+    }
+    if (code === SCENARIO_ASSIGNMENT_UNKNOWN_ERROR_CODE) {
+        const name = typeof scenario === 'string' && scenario.length > 0 ? ` ("${capForDisplay(scenario, 80)}")` : '';
+        const from = source === 'ruling' ? ', assigned to you by the configuration center,' : source === 'deployment' ? ", this deployment's default scenario," : '';
+        return (`This deployment cannot resolve your scenario: the scenario${name}${from} does not exist here, so it refuses whatever depends on your scenario — ` +
+            "new runs that do not name a scenario, and this session's list of MCP servers · Ask whoever operates the engine to fix the scenario assignment");
+    }
+    const tail = typeof code === 'string' && code.length > 0 ? ` (${capForDisplay(code, 80)})` : '';
+    return `This deployment's scenario check refused to resolve your scenario${tail}, so whatever depends on your scenario is not available — this session's list of MCP servers is unknown`;
+}

package/dist/scenarioWire.js

@@ -4,7 +4,7 @@ export const SCENARIO_NAME_RE = /^[a-z][a-z0-9-]{1,31}$/;
 export const HEADLESS_SCENARIO_ENV = 'SEMA_HEADLESS_SCENARIO';
 const USAGE_HINT = "sema: --scenario expects a scenario name (lowercase letters/digits/hyphens, starting with a letter, ≤32 chars).\n" +
     '  --scenario <name>    route this run through the named engine scenario (deployment-defined tool\n' +
-    '                       roster + system prompt; unknown names fall back to the default scenario)\n' +
+    '                       roster + system prompt; unknown names are refused by the engine (scenario_unknown))\n' +
     '  (no flag)            the default scenario — today\'s behaviour';
 export function parseScenarioArgv(argv) {
     const flag = lastFlagValue(argv, '--scenario');

package/dist/seam.d.ts

@@ -5,6 +5,8 @@ import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcp
 import type { ToolRosterView, ToolRosterDeltaView, WiringManifestHandsView } from './toolRoster.js';
 import type { WiringManifestFleetView } from './adapter/downstream/wiringManifestView.js';
 import type { SuspendedReopenReading } from './hitl/suspendedReopen.js';
+import type { ToolKillCause } from './toolResult.js';
+import type { HumanInputAttachmentView } from './ownKey.js';
 export interface AbortSignalLike {
     readonly aborted: boolean;
 }
@@ -27,7 +29,18 @@ export interface AdapterContext {
     signal?: AbortSignalLike;
     setTimer?(ms: number, fn: () => void): TimerHandle;
     clearTimer?(handle: TimerHandle): void;
+    toolKillCause?(call: {
+        readonly toolCallId: string;
+        readonly toolName: string;
+    }): ToolKillCause | undefined;
     coalesceIntervalMs?: number;
+    continuesPark?: ContinuesParkDeclaration;
+}
+export interface ContinuesParkDeclaration {
+    readonly toolCallId: string;
+    readonly checkpointId?: string;
+    readonly parkedTaskId?: string;
+    readonly continuationTaskId?: string;
 }
 export type ChromeEvent = {
     kind: 'retry_status';
@@ -131,6 +144,7 @@ export type ChromeEvent = {
     laneProof: LaneProof;
     usage: ModelUsage;
     engineUsage?: EngineTurnUsage;
+    engineUsageUnknownKeys?: number;
     usageMissing?: true;
     stopReason?: string;
     responseModel?: string;
@@ -142,6 +156,7 @@ export type ChromeEvent = {
     parentToolCallId: string;
     usage?: ModelUsage;
     engineUsage?: EngineTurnUsage;
+    engineUsageUnknownKeys?: number;
     usageMissing?: true;
     stopReason?: string;
     responseModel?: string;
@@ -152,7 +167,7 @@ export type ChromeEvent = {
 } | ({
     kind: 'run_cost_reconciled';
     laneProof: LaneProof;
-} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | {
+} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | SubagentStartedChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ResultReplayedChromeEvent | ToolParkedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent | {
     kind: 'suspended_reopened';
     laneProof: LaneProof;
     reopen: Extract<SuspendedReopenReading, {
@@ -222,6 +237,25 @@ export interface CompactionOutcomeChromeEvent {
     reason?: string;
     eventId?: string;
 }
+export interface SubagentStartedChromeEvent {
+    kind: 'subagent_started';
+    laneProof: LaneProof;
+    taskId: string;
+    sessionId?: string;
+    model?: string;
+    taskType?: string;
+    seq?: number;
+    workflowRunId?: string;
+    workflowAgentLabel?: string;
+    parentTaskId?: string;
+    parentSessionId?: string;
+    rootSessionId?: string;
+    name?: string;
+    spawnName?: string;
+    agentType?: string;
+    startedAt?: number;
+    eventId?: string;
+}
 export interface MemorySavedChromeEvent {
     kind: 'memory_saved';
     laneProof: LaneProof;
@@ -286,6 +320,17 @@ export interface ResultTextDivergedChromeEvent {
     committedLength: number;
     resultLength: number;
 }
+export interface ResultReplayedChromeEvent {
+    kind: 'result_replayed';
+    laneProof: LaneProof;
+    text: string;
+}
+export interface ToolParkedChromeEvent {
+    kind: 'tool_parked';
+    laneProof: LaneProof;
+    toolUseId: string;
+    rowUuid?: string;
+}
 export interface EngineNoticeChromeEvent {
     kind: 'engine_notice';
     laneProof: LaneProof;
@@ -314,7 +359,9 @@ export interface HumanInputChromeEvent {
     actor?: HumanInputActor;
     entryId?: string;
     eventId?: string;
+    attachments?: HumanInputAttachmentView[];
 }
+export type { HumanInputAttachmentView } from './ownKey.js';
 export interface MessageCommittedChromeEvent {
     kind: 'message_committed';
     laneProof: LaneProof;
@@ -352,6 +399,5 @@ export interface WireToCcAdapter {
 }
 export declare function deriveTranscriptId(frame: {
     id?: unknown;
-    seq?: unknown;
     toolCallId?: unknown;
 }, ctx: Pick<AdapterContext, 'uuid'>, suffix?: string): string;

package/dist/seam.js

@@ -76,6 +76,14 @@ const CHROME_ARM_TABLE = {
         duty: 'CC-89(0.75.0):一次压缩的非 compacted 结局(作废 / 失败等),给用户一条可见提示。`outcome` / `trigger` 是引擎开集原词,按成员渲染必带 default 臂、认不得照原词显示;' +
             '🔴 不是终态 —— 任务还在跑,别据它收 spinner;`laneProof.lane` 为 subagent = 子代的压缩结局,别渲成主会话的;成功压缩不走本臂(权威是转录的 compact_boundary)。不接 = 压缩失败对用户不可见。',
     },
+    subagent_started: {
+        required: false,
+        duty: '可选:委派子代每周期一帧的起跑事实(sdk `task_started`,服务端 ≥ 7.127.0)—— 要「起跑时就开子代行」的宿主接它(不接 = 首个 task_progress 才开行,与 0.98.0 同)。' +
+            '🔴 面板的起跑时刻证据:把本事件原样交 `publishEngineAgentPanelStart(event)`(只补行上缺的 `startedAt`、从不建行 / 不改身份归并;workflow 车道自报 `workflowRunId` 的帧它自己忽略)。' +
+            '🔴 `taskType` 开集读(缺席 = 前台同步子代,没有 fleet 行);`seq` 缺席 = 没有 a* 行,禁读作第 1 周期;`name` / `workflowAgentLabel` 是 UNTRUSTED 展示文本(渲前过展示出口);' +
+            '`laneProof.lane` 为 subagent = 挂在那张委派卡上(`parentToolCallId`),主车道 = 后台代理(卡已收口);workflow 车道的子代别开前台子代行(带 `workflowRunId` 即是);' +
+            '本事件不是 spinner / run 终态证据;缺席键 = 服务端没说,不是 0 / 空串。',
+    },
     prompt_assembled: {
         required: false,
         duty: 'CC-91(0.76.0):这一次 prepare 的提示词装配清单(每段 / 块多大、挂了哪些工具),/context 类面板的引擎侧真值来源。🔴 一次任务可能多条(cascade / verify / resume 各自 re-prepare)' +
@@ -113,6 +121,19 @@ const CHROME_ARM_TABLE = {
             'mcp 的空数组是「一台都没申报」这句正面事实、**不是**缺席(判在场写 mcp !== undefined,' +
             '别写 mcp?.length),errorCode 按开集分支必带 default;durable 重放按 run/leg 幂等',
     },
+    result_replayed: {
+        required: true,
+        duty: '0.98.0:提交幂等的重放(同一把幂等键命中更早的一次提交,这次没有新跑)。每个重放终局恰一条,在终局臂全部产出之后;渲一行 `text`,不进模型面。' +
+            '🔴 零转录行的重放终局(空正文成功 / 停驻)里本臂是这一轮唯一的可渲染产出 —— 不接 = 整轮无提示;' +
+            '句子只说「这次没有新跑」,结局由已有的行与结果帧说,别在本臂上拼结局,也别从行上的 `_sema_replay` 现拼句子;' +
+            '没收到本臂 ≠ 这次真跑;续读 / 接管重投的终局永不发本臂;冷恢复后看不到是诚实缺席(要留就把渲成的那一行随转录落盘)。',
+    },
+    tool_parked: {
+        required: true,
+        duty: '0.98.0:被停驻扣住的那只调用此刻是「停驻、没结算」—— 摘卡那一拍恰一枚(同一拍零终态行)。把 `rowUuid` 那一行(调用 occurrence 的开始行)置「在等审批」;' +
+            '按开始行 uuid 认行,不按 toolUseId(调用 id 只在同一条助手消息内唯一)。它的终态由执行腿的结果铸(续跑带见证时接回原行),或永远缺席(停驻被取消 / 过期)。' +
+            '连坐旁观者 / 普通错误 / 停驻卡上 Esc(包已自发中断拒绝,行照铸 Interrupted)零枚。',
+    },
     result_text_diverged: {
         required: false,
         duty: '可选:终帧正文与已上屏正文**互相都不是对方前缀**时的诚实披露。🔴 处置是把这一拍的转录行**改口**' +
@@ -123,7 +144,8 @@ const CHROME_ARM_TABLE = {
     approval_request: {
         required: true,
         duty: '用 sdk isApprovalRequestFrameV1 窄化 frame 才取 card/askId/窗三键;窄不下来 ⇒ 呈通用卡(安全元数据 + 人工 approve/deny),' +
-            '🔴 永不 auto-deny;按 approvalId 与 legacy tool_approval 帧去重(同一只 ask 出两帧,优先渲本帧);' +
+            '🔴 永不 auto-deny;开卡前调 claimApprovalCard(身份, { signal }):joined / aborted ⇒ 不开卡,held ⇒ 开卡且每条出口恰调一次 hold.release(settled?)' +
+            '(去重判定归包 —— legacy 帧那一路的持有与结局在进程级持有表 / 已结表里,宿主不自持 legacy 已收口集);流上下文经 approvalFrameContextOf(这只 chrome 事件) 查,查不到不开卡;' +
             '🔴 账本重放的历史帧只用于时间线渲染,卡集的全量对账基准是开流 preamble(它带的 expiresInMs 是铸帧时刻的旧值);' +
             'card 的 message/args 是模型/工具产文,只渲染永不回喂模型',
     },
@@ -155,14 +177,13 @@ const CHROME_ARM_TABLE = {
             '⑦序:该段尾部的活体增量(`stream_delta`)一律先于本事件到达,本事件之后不再有同段增量(下一条增量属于下一段)。',
     },
 };
+const _chromeArmRequiredFloorPins = [true, true];
+void _chromeArmRequiredFloorPins;
 export const CHROME_ARMS = Object.entries(CHROME_ARM_TABLE).map(([kind, d]) => ({ kind, required: d.required, duty: d.duty }));
 export function deriveTranscriptId(frame, ctx, suffix) {
     if (typeof frame.id === 'string' && frame.id.length > 0) {
         return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wid_${frame.id}#${suffix}` : `wid_${frame.id}`);
     }
-    if (typeof frame.seq === 'number') {
-        return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wseq#${suffix}_${frame.seq}` : `wseq_${frame.seq}`);
-    }
     if (typeof frame.toolCallId === 'string' && frame.toolCallId.length > 0) {
         return uuidV5(TRANSCRIPT_ID_NAMESPACE, suffix !== undefined ? `wtc#${suffix}_${frame.toolCallId}` : `wtc_${frame.toolCallId}`);
     }