@sema-agent/client-core 0.88.0 → 0.89.0

package/dist/runTerminal.js

@@ -20,6 +20,27 @@ function pauseOf(v) {
         ...(restoreMode !== undefined ? { restoreMode } : {}),
     };
 }
+const PROVIDER_REJECTED_DETAIL_KIND = 'provider_rejected';
+function failureDetailOf(cause) {
+    try {
+        const own = (o, k) => (Object.prototype.hasOwnProperty.call(o, k) ? o[k] : undefined);
+        const v = own(cause, 'detail');
+        if (typeof v !== 'object' || v === null || Array.isArray(v))
+            return undefined;
+        const kind = str(own(v, 'kind'));
+        if (kind === undefined)
+            return undefined;
+        const rawStatus = own(v, 'status');
+        const status = typeof rawStatus === 'number' && Number.isInteger(rawStatus) && rawStatus >= 100 && rawStatus <= 599 ? rawStatus : undefined;
+        if (kind === PROVIDER_REJECTED_DETAIL_KIND && (status === undefined || status < 400))
+            return undefined;
+        const code = str(own(v, 'code'));
+        return { kind, ...(status !== undefined ? { status } : {}), ...(code !== undefined ? { code } : {}) };
+    }
+    catch {
+        return undefined;
+    }
+}
 const FLAT_PAUSED_STATUSES = ['suspended', 'needs_review'];
 export function readRunTerminal(result) {
     if (typeof result !== 'object' || result === null || Array.isArray(result))
@@ -44,12 +65,14 @@ export function readRunTerminal(result) {
                 const code = str(c.code);
                 const message = str(c.message);
                 const nestedPause = c.nestedPause !== undefined ? pauseOf(c.nestedPause) : undefined;
+                const detail = failureDetailOf(c);
                 return {
                     kind: 'failed',
                     plane: 'cause',
                     ...(code !== undefined ? { code } : {}),
                     ...(message !== undefined ? { message } : {}),
                     ...(nestedPause !== undefined ? { nestedPause } : {}),
+                    ...(detail !== undefined ? { detail } : {}),
                 };
             }
             case 'blocked': {

package/dist/seam.d.ts

@@ -174,6 +174,9 @@ export interface WiringManifestChromeEvent {
     readDeny?: WiringManifestReadDenyView;
     hands?: WiringManifestHandsView;
     fileHistory?: string;
+    instructions?: {
+        readonly selected: readonly string[];
+    };
     eventId?: string;
 }
 export interface TextSegmentCommittedRow {

package/dist/seatContract.d.ts

@@ -61,6 +61,8 @@ export interface ToolPermissionRequest {
     mandate?: ApprovalMandateWord;
     origin?: string;
     ruleOffersAbsence?: string;
+    askClass?: string;
+    classes?: readonly string[];
 }
 declare const SEAT_EVENT_TYPE_TUPLE: readonly ["start", "close", "session_updated", "message", "stream_event", "chrome_event", "error", "tool_permission_resolved"];
 export type SeatEventType = (typeof SEAT_EVENT_TYPE_TUPLE)[number];
@@ -261,7 +263,7 @@ export declare const SEAT_METHOD_NAMES: readonly ["start", "sendMessage", "inter
 export declare const SEAT_STORE_PROPS: readonly ["sessionsStateStore", "focusedSessionStateStore", "settingsStateStore"];
 export declare const SEAT_EVENT_METHOD_NAMES: readonly ["onEvent", "onToolPermissionRequest"];
 export declare const LOCAL_SESSION_EVENT_KEYS: readonly ["type", "sessionId", "message", "messages", "error", "errorCategory", "code", "request", "data", "sources", "permissionMode", "session", "userMessageUuid", "hasPreClearSession", "requestId", "outcome", "chrome"];
-export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence"];
+export declare const TOOL_PERMISSION_REQUEST_KEYS: readonly ["requestId", "sessionId", "toolName", "toolCallId", "input", "message", "toctouBinding", "createdAtMs", "governanceForced", "delegation", "mandated", "mandate", "origin", "ruleOffersAbsence", "askClass", "classes"];
 export declare const LOCAL_SESSION_RECORD_KEYS: readonly ["sessionId", "engineSessionId", "model", "title", "isRunning", "createdAt", "lastActivityAt", "queuedMessages", "parked"];
 export declare const SEND_MESSAGE_REQUEST_KEYS: readonly ["sessionId", "text", "model", "userMessageUuid", "permissionMode", "attachmentIds", "reasoningEffort", "retainBackgroundProcesses", "forwardSubagentEvents", "retainSubagentSessions", "settings", "scenario"];
 export declare const SEAT_SEND_MESSAGE_KEY_ORIGINS: {
@@ -333,6 +335,12 @@ export declare const SEAT_VALIDATOR_KEY_COVERAGE: {
         }, {
             readonly key: "origin";
             readonly why: "喂姿态谓词 askSurvivesPosture 的安全位(CC-203),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口 toolPermissionRequestAskBits,座位门不设第二判官(为一个位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。坏形的两种失效方向:非串 / 空串读成缺席 ⇒ 宿主报了没命中时姿态谓词可答可以放(放宽方向:真出身若是必问词就丢了);表外串读成不认识的词 ⇒ 答 unknown,宿主退回自己的规则(不放宽)。不经过境口自铸座位请求的宿主要自己按同一把窄读。";
+        }, {
+            readonly key: "askClass";
+            readonly why: "展示位(CC-284),权威成对窄读在卡口与过境口 toolPermissionRequestAskBits(与 classes 同在同缺、首员等于 askClass、不判成员、不重排);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎超时拒)。坏形读成缺席 ⇒ 卡上不显示问类,不改决断;缺席不是「普通问」。不经过境口自铸座位请求的宿主要自己按同一把成对窄读。";
+        }, {
+            readonly key: "classes";
+            readonly why: "与 askClass 同一对(CC-284),同在同缺、同一只成对窄读(非空、每员非空串、无重复、首员等于 askClass;开集、原样顺序);座位门不设第二判官,理由同 askClass。";
         }, {
             readonly key: "ruleOffersAbsence";
             readonly why: "喂强制判据口 approvalIsMandated 的位(CC-203;寄存行那条腿的强制只以缺席词 mandated 表达),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口,座位门不设第二判官,理由同 mandated。坏形读成缺席 ⇒ 这一路不判强制(放宽方向:寄存行上的强制就丢了;另两路 mandated / mandate 照判);表外串只是不等于 mandated。不经过境口自铸座位请求的宿主要自己按同一把窄读。";

package/dist/seatContract.js

@@ -478,6 +478,8 @@ export const TOOL_PERMISSION_REQUEST_KEYS = [
     "mandate",
     "origin",
     "ruleOffersAbsence",
+    "askClass",
+    "classes",
 ];
 export const LOCAL_SESSION_RECORD_KEYS = [
     "sessionId",
@@ -563,6 +565,14 @@ export const SEAT_VALIDATOR_KEY_COVERAGE = {
                 key: "origin",
                 why: "喂姿态谓词 askSurvivesPosture 的安全位(CC-203),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口 toolPermissionRequestAskBits,座位门不设第二判官(为一个位拒掉整条 request = 把安全 ask 丢给引擎 TTL deny)。坏形的两种失效方向:非串 / 空串读成缺席 ⇒ 宿主报了没命中时姿态谓词可答可以放(放宽方向:真出身若是必问词就丢了);表外串读成不认识的词 ⇒ 答 unknown,宿主退回自己的规则(不放宽)。不经过境口自铸座位请求的宿主要自己按同一把窄读。",
             },
+            {
+                key: "askClass",
+                why: "展示位(CC-284),权威成对窄读在卡口与过境口 toolPermissionRequestAskBits(与 classes 同在同缺、首员等于 askClass、不判成员、不重排);座位门不设第二判官,理由同 mandated(为一个展示位拒掉整条 request = 把安全 ask 丢给引擎超时拒)。坏形读成缺席 ⇒ 卡上不显示问类,不改决断;缺席不是「普通问」。不经过境口自铸座位请求的宿主要自己按同一把成对窄读。",
+            },
+            {
+                key: "classes",
+                why: "与 askClass 同一对(CC-284),同在同缺、同一只成对窄读(非空、每员非空串、无重复、首员等于 askClass;开集、原样顺序);座位门不设第二判官,理由同 askClass。",
+            },
             {
                 key: "ruleOffersAbsence",
                 why: "喂强制判据口 approvalIsMandated 的位(CC-203;寄存行那条腿的强制只以缺席词 mandated 表达),按开集读(非空串原文字节、词表不校);权威窄读在卡口与过境口,座位门不设第二判官,理由同 mandated。坏形读成缺席 ⇒ 这一路不判强制(放宽方向:寄存行上的强制就丢了;另两路 mandated / mandate 照判);表外串只是不等于 mandated。不经过境口自铸座位请求的宿主要自己按同一把窄读。",

package/dist/subagent/engineSubagentSteer.d.ts

@@ -4,10 +4,17 @@ export type SubagentSteerWireClient = {
     runs: Pick<AgentClient['runs'], 'steerSubagent'>;
 };
 export type SubagentSteerWire = EngineWireInjection<SubagentSteerWireClient>;
+export interface SubagentSteerNotDelivered {
+    ok: false;
+    reason: 'not-delivered';
+    safety: 'ledger_unavailable';
+    detail: string;
+}
 export type SubagentSteerOutcome = {
     ok: true;
     receipt: string;
-} | {
+    messageId?: string;
+} | SubagentSteerNotDelivered | {
     ok: false;
     reason: 'no-wire' | 'no-run' | 'not-running' | 'error';
     detail?: string;

package/dist/subagent/engineSubagentSteer.js

@@ -3,9 +3,21 @@ import { clientHasVerbs, engineWireFor, INJECTED_WIRE_SETTLE_MS, noAnswerDetailF
 import { engineSessionParamFor } from '../engineSessionParam.js';
 import { resolveOwnerContext, resolveOwnerRunId } from './engineSubagentResume.js';
 import { noteBgOwnerAbsence } from './subagentOwnerAbsence.js';
+import { errCodes, steeringRefusedBeforeEngine } from '../controlRouter.js';
 function usableSteerClient(client) {
     return clientHasVerbs(client, [['runs', 'steerSubagent']]);
 }
+function steerReceiptMessageId(body) {
+    try {
+        if (typeof body !== 'object' || body === null || !Object.hasOwn(body, 'messageId'))
+            return undefined;
+        const v = body.messageId;
+        return typeof v === 'string' && v.length > 0 ? v : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 export async function steerEngineSubagent(target, text, childTaskId, opts) {
     const named = typeof childTaskId === 'string' && childTaskId !== '' ? childTaskId : undefined;
     const { record: owner, key } = resolveOwnerContext(named);
@@ -36,13 +48,24 @@ export async function steerEngineSubagent(target, text, childTaskId, opts) {
         const copy = body?.note ?? body?.message;
         if (typeof copy === 'string' && copy.length > 0)
             receipt = copy;
-        return { ok: true, receipt };
+        const messageId = steerReceiptMessageId(body);
+        return messageId === undefined ? { ok: true, receipt } : { ok: true, receipt, messageId };
     }
     catch (e) {
-        const status = e?.status;
-        if (typeof status === 'number') {
+        let status;
+        try {
+            status = errCodes(e).status;
+        }
+        catch {
+            status = undefined;
+        }
+        if (status !== undefined) {
             const detail = e instanceof Error ? e.message : String(e);
             hostLog('debug', `engineSubagentSteer: ${status} ${detail.slice(0, 200)}`);
+            const refused = typeof e === 'object' && e !== null ? steeringRefusedBeforeEngine(e) : undefined;
+            if (refused !== undefined && refused.safety === 'ledger_unavailable') {
+                return { ok: false, reason: 'not-delivered', safety: refused.safety, detail: refused.advice };
+            }
             if (status === 409 || status === 404) {
                 return { ok: false, reason: 'not-running', detail };
             }