@sema-agent/client-core 0.83.1 → 0.83.2

package/dist/hitl/toolApprovalWire.d.ts

@@ -1,5 +1,6 @@
 import { type GateCurrentPending, type HitlFailureStage, type HitlSafetyCode, type HitlClientLike, type DecideOperationObserver } from './hitlBridge.js';
 import { type RuleStoreUnreadableKind } from '../gateVocabulary.js';
+import { type ApprovalMandateWord } from '../gateVocabulary.js';
 import { type DenyAttributionRefusalDetail } from '../wireRefusalCopy.js';
 import { type DecideReceiptView } from '../decideReceipt.js';
 import { RULE_OFFER_MATCHES, RULE_OFFER_BATCH_MEMBER_KINDS, RULE_OFFER_UNCOVERED_REASONS, RULE_OFFERS_ABSENCE_REASONS, DENIAL_LIMIT_KINDS } from '@sema-agent/sdk';
@@ -137,6 +138,7 @@ export interface ApprovalCardRequest {
     receivedAtMs?: number;
     ruleOffersAbsence?: string;
     mandated?: true;
+    mandate?: ApprovalMandateWord;
     denialLimitFallback?: DenialLimitFallback;
     origin?: string;
     ruleStoreUnreadable?: RuleStoreUnreadableKind;
@@ -176,6 +178,7 @@ export interface ToolApprovalFrame {
     ruleEvidence?: unknown;
     requiresRealApproval?: true;
     mandated?: true;
+    mandate?: string;
     origin?: string;
     inputHasBidi?: true;
     parked?: true;
@@ -194,11 +197,16 @@ export interface ToolApprovalDelegation {
     depth: number;
     agentName?: string;
 }
-export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "ruleSuggestions", "ruleOffers", "ruleOffersAbsence", "denialLimitFallback", "ruleStoreUnreadable", "readRootCandidate", "mandated", "origin", "inputHasBidi", "parked", "persistedRuleShadowed", "probeCause", "ruleEvidence", "requiresRealApproval", "expiresInMs", "expiresAtMs", "serverNowMs", "delegation", "outcome"];
-export declare function approvalIsMandated(v: {
-    mandated?: true;
-    ruleOffersAbsence?: string;
-} | undefined | null): boolean;
+export declare const TOOL_APPROVAL_FRAME_KEYS_MIRROR: readonly ["type", "approvalId", "toolCallId", "toolName", "sourceTaskId", "fromSubagent", "sourceAgentName", "message", "args", "argsOmitted", "governanceForced", "ruleSuggestions", "ruleOffers", "ruleOffersAbsence", "denialLimitFallback", "ruleStoreUnreadable", "readRootCandidate", "mandated", "mandate", "origin", "inputHasBidi", "parked", "persistedRuleShadowed", "probeCause", "ruleEvidence", "requiresRealApproval", "expiresInMs", "expiresAtMs", "serverNowMs", "delegation", "outcome"];
+export interface ApprovalMandatedFacts {
+    readonly mandated?: true;
+    readonly ruleOffersAbsence?: string;
+    readonly mandate?: string;
+}
+export declare function approvalIsMandated(v: ApprovalMandatedFacts | undefined | null): boolean;
+export declare function readApprovalMandate(v: {
+    readonly mandate?: string;
+} | undefined | null): ApprovalMandateWord | undefined;
 export declare function isFromSubagent(frame: ToolApprovalFrame): boolean;
 export type ToolApprovalRespondDecision = 'allow' | 'allow_session' | 'deny';
 export interface RespondToolApprovalOpts {

package/dist/hitl/toolApprovalWire.js

@@ -1,11 +1,13 @@
 import { DEFAULT_DENY_REASON, DecideTransportRetryExhaustedError, HitlBridge, HitlSafetyError, denyReasonForWire, findPendingForTask, readDecideCurrentPending, readWireErrorCode, } from './hitlBridge.js';
 import { askParkRowArm } from './askParkRowRouting.js';
 import { hostLog } from '../host.js';
+import { readOwnNonEmptyString } from '../ownKey.js';
 import { createSessionSlot, DEFAULT_SESSION_KEY } from '../sessionSlot.js';
 import { readEngineActiveBgTasks } from '../fleet/fleetLedger.js';
 import { observeCancelByDeny, surfaceRememberNotApplied, surfaceEditNotForwarded, surfaceEditRefusedOnBlindAsk, surfaceRuleArmNotSent, surfaceRuleArmRejected } from './hitlHostSurface.js';
 import { approvalCallKey, liveFrameCallKey } from './gateIdentity.js';
 import { isRuleStoreUnreadableKind } from '../gateVocabulary.js';
+import { isApprovalMandateWord } from '../gateVocabulary.js';
 import { denyAttributionRefusalFromError } from '../wireRefusalCopy.js';
 import { decideFailureNote } from '../decideFailureNote.js';
 import { readDecideReceipt } from '../decideReceipt.js';
@@ -205,6 +207,8 @@ export async function surfaceFsApprovalAndDecide(deps, taskId, argsByCall, signa
         ...(pending.governanceForced === true ? { governanceForced: true } : {}),
         ...(pending.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
         ...(pending.mandated === true ? { mandated: true } : {}),
+        ...((w) => (w !== undefined ? { mandate: w } : {}))(readApprovalMandate(pending)),
+        ...((o) => (o !== undefined ? { origin: o } : {}))(readOwnNonEmptyString(pending, 'origin')),
         ...(pending.gateKind === 'irreversible_ask' ? { irreversibleParkGate: true } : {}),
         ...(pending.hasBidiControls === true ? { hasBidiControls: true } : {}),
         ...(ruleOffersReadOnly !== undefined ? { ruleOffersReadOnly } : {}),
@@ -379,6 +383,7 @@ export const TOOL_APPROVAL_FRAME_KEYS_MIRROR = [
     'ruleStoreUnreadable',
     'readRootCandidate',
     'mandated',
+    'mandate',
     'origin',
     'inputHasBidi',
     'parked',
@@ -400,7 +405,15 @@ export function approvalIsMandated(v) {
         return false;
     if (v.mandated === true)
         return true;
-    return v.ruleOffersAbsence === MANDATED_ABSENCE_WORD;
+    if (v.ruleOffersAbsence === MANDATED_ABSENCE_WORD)
+        return true;
+    return readApprovalMandate(v) !== undefined;
+}
+export function readApprovalMandate(v) {
+    if (typeof v !== 'object' || v === null || !Object.hasOwn(v, 'mandate'))
+        return undefined;
+    const raw = v.mandate;
+    return isApprovalMandateWord(raw) ? raw : undefined;
 }
 function isToolApprovalDelegation(v) {
     if (v === null || typeof v !== 'object')
@@ -828,6 +841,7 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
         ...(isWireRecordCarrier(frame.ruleEvidence) ? { ruleEvidence: frame.ruleEvidence } : {}),
         ...(frame.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
         ...(frame.mandated === true ? { mandated: true } : {}),
+        ...((w) => (w !== undefined ? { mandate: w } : {}))(readApprovalMandate(frame)),
         ...(() => { const rc = readReadRootCandidate(frame.readRootCandidate); return rc !== undefined ? { readRootCandidate: rc } : {}; })(),
         ...(frame.inputHasBidi === true ? { inputHasBidi: true } : {}),
         ...(typeof frame.ruleOffersAbsence === 'string' && frame.ruleOffersAbsence !== ''
@@ -835,7 +849,7 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
             : {}),
         ...(denialLimitFallback !== undefined ? { denialLimitFallback } : {}),
         ...((k) => (k !== undefined ? { ruleStoreUnreadable: k } : {}))(readRuleStoreUnreadable(frame.ruleStoreUnreadable)),
-        ...(typeof frame.origin === 'string' && frame.origin !== '' ? { origin: frame.origin } : {}),
+        ...((o) => (o !== undefined ? { origin: o } : {}))(readOwnNonEmptyString(frame, 'origin')),
     });
     if (argsNotRealInput && card.kind === 'allow' && card.updatedInput !== undefined) {
         hostLog('error', `liveToolApprovalWire: ${approvalId} card returned an edited approval on a card whose arguments are not the tool's real input (${lane?.argsUnavailable === true ? 'args-unavailable ask' : 'arguments omitted or absent on the frame'}) — nothing sent (the ask stays pending)`);

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export * from './sdkWireTransit.js';
 export { SEMA_SEGMENT_ID_KEY } from './adapt/textStream.js';
 export * from './subagentContentStore.js';
 export * from './engineAgentPanelStore.js';
+export * from './engineAgentAbsence.js';
 export * from './fleetAgentPanelProjection.js';
 export * from './liveQuestionStore.js';
 export * from './engineInlineTaskStats.js';
@@ -166,6 +167,7 @@ export * from './hitl/sessionPolicyWire.js';
 export * from './hitl/sessionPolicyDeliverable.js';
 export * from './hitl/approvalsFeed.js';
 export * from './hitl/livePendingAsk.js';
+export * from './hitl/askSurvivesPosture.js';
 export * from './hitl/crashConverged.js';
 export * from './interactiveHalt.js';
 export * from './compensations.js';

package/dist/index.js

@@ -14,6 +14,7 @@ export * from './sdkWireTransit.js';
 export { SEMA_SEGMENT_ID_KEY } from './adapt/textStream.js';
 export * from './subagentContentStore.js';
 export * from './engineAgentPanelStore.js';
+export * from './engineAgentAbsence.js';
 export * from './fleetAgentPanelProjection.js';
 export * from './liveQuestionStore.js';
 export * from './engineInlineTaskStats.js';
@@ -163,6 +164,7 @@ export * from './hitl/sessionPolicyWire.js';
 export * from './hitl/sessionPolicyDeliverable.js';
 export * from './hitl/approvalsFeed.js';
 export * from './hitl/livePendingAsk.js';
+export * from './hitl/askSurvivesPosture.js';
 export * from './hitl/crashConverged.js';
 export * from './interactiveHalt.js';
 export * from './compensations.js';

package/dist/ownKey.d.ts

@@ -1 +1,2 @@
 export declare function putOwnKey<T>(table: Record<string, T>, key: string, value: T): void;
+export declare function readOwnNonEmptyString(v: object | null | undefined, key: string): string | undefined;

package/dist/ownKey.js

@@ -1,3 +1,9 @@
 export function putOwnKey(table, key, value) {
     Object.defineProperty(table, key, { value, enumerable: true, writable: true, configurable: true });
 }
+export function readOwnNonEmptyString(v, key) {
+    if (typeof v !== 'object' || v === null || !Object.hasOwn(v, key))
+        return undefined;
+    const raw = v[key];
+    return typeof raw === 'string' && raw !== '' ? raw : undefined;
+}