@sema-agent/client-core 0.107.0 → 0.109.0

package/dist/engineErrorCodes.d.ts

@@ -49,6 +49,10 @@ export declare const ATTACHMENT_BUNDLE_SEED_FIXED = "attachment.bundle_seed_fixe
 export declare const ATTACHMENT_BOUND_ELSEWHERE = "attachment.bound_elsewhere";
 export declare const CONFLICT_SESSION_MEMORY_UNOBSERVED = "conflict.session_memory_unobserved";
 export declare const CONFLICT_SESSION_ARCHIVE_STAMPED = "conflict.session_archive_stamped";
+export declare const REQUEST_ENV_CREDENTIAL_REFUSED = "request.env_credential_refused";
+export declare const CONFLICT_SESSION_ID_RETIRED = "conflict.session_id_retired";
+export declare const LIMIT_RATE_EXCEEDED = "limit.rate_exceeded";
+export declare const RATE_EXCEEDED_RUN_CONCURRENCY_CAP = "run_concurrency_cap";
 export declare const GATE_PARKED_ERROR_CODE = "gate.parked";
 export declare const ACTIVE_RUN_BUSY_ERROR_CODE = "conflict.session_active_run";
 export declare const CONFLICT_IDEMPOTENCY_PAYLOAD_MISMATCH = "conflict.idempotency_payload_mismatch";
@@ -99,6 +103,11 @@ export declare function refusalSaysStillPending(err: object): boolean;
 export declare function refusalRetriableReading(err: object): boolean | undefined;
 export type StatusDerivedCoarseCode = (typeof SDK_STATUS_DERIVED_COARSE_CODES)[number];
 export declare const RESUME_PLACEMENT_MISMATCH = "resume.placement_mismatch";
+export declare const RESUME_PRINCIPAL_MISMATCH = "resume.principal_mismatch";
+export declare const RESUME_COMPOSITION_MISMATCH = "resume.composition_mismatch";
+export declare const RESUME_PARENT_CONSTRAINT_MISSING = "resume.parent_constraint_missing";
+export declare const RESUME_PARENT_CONSTRAINT_MISMATCH = "resume.parent_constraint_mismatch";
+export declare const RESUME_CONSTRAINT_UNPROJECTABLE = "resume.constraint_unprojectable";
 export declare const RESUME_CONTEXT_UNAVAILABLE = "conflict.resume_context_unavailable";
 export declare const RESUME_RETRY_LATER_CODES: readonly string[];
 export declare const RESUME_ENV_FAILED = "resume.env_failed";

package/dist/engineErrorCodes.js

@@ -73,6 +73,10 @@ export const ATTACHMENT_BUNDLE_SEED_FIXED = 'attachment.bundle_seed_fixed';
 export const ATTACHMENT_BOUND_ELSEWHERE = 'attachment.bound_elsewhere';
 export const CONFLICT_SESSION_MEMORY_UNOBSERVED = 'conflict.session_memory_unobserved';
 export const CONFLICT_SESSION_ARCHIVE_STAMPED = 'conflict.session_archive_stamped';
+export const REQUEST_ENV_CREDENTIAL_REFUSED = 'request.env_credential_refused';
+export const CONFLICT_SESSION_ID_RETIRED = 'conflict.session_id_retired';
+export const LIMIT_RATE_EXCEEDED = 'limit.rate_exceeded';
+export const RATE_EXCEEDED_RUN_CONCURRENCY_CAP = 'run_concurrency_cap';
 export const GATE_PARKED_ERROR_CODE = 'gate.parked';
 export const ACTIVE_RUN_BUSY_ERROR_CODE = 'conflict.session_active_run';
 export const CONFLICT_IDEMPOTENCY_PAYLOAD_MISMATCH = 'conflict.idempotency_payload_mismatch';
@@ -177,6 +181,11 @@ export function refusalRetriableReading(err) {
     }
 }
 export const RESUME_PLACEMENT_MISMATCH = 'resume.placement_mismatch';
+export const RESUME_PRINCIPAL_MISMATCH = 'resume.principal_mismatch';
+export const RESUME_COMPOSITION_MISMATCH = 'resume.composition_mismatch';
+export const RESUME_PARENT_CONSTRAINT_MISSING = 'resume.parent_constraint_missing';
+export const RESUME_PARENT_CONSTRAINT_MISMATCH = 'resume.parent_constraint_mismatch';
+export const RESUME_CONSTRAINT_UNPROJECTABLE = 'resume.constraint_unprojectable';
 export const RESUME_CONTEXT_UNAVAILABLE = 'conflict.resume_context_unavailable';
 export const RESUME_RETRY_LATER_CODES = Object.freeze([
     RESUME_USAGE_WINDOW_EXHAUSTED,

package/dist/engineHealthFacts.d.ts

@@ -8,6 +8,7 @@ export interface EngineHealthAuthFacts {
     readonly required: boolean;
     readonly kinds: readonly (HealthAuthKind | (string & {}))[];
     readonly identityAttach: 'available' | 'unavailable';
+    readonly serviceTokenActsForDeployment?: boolean;
 }
 export interface EngineHealthDrainingFacts {
     readonly actionId: string;
@@ -17,6 +18,19 @@ export interface EngineHealthDrainingFacts {
 export interface EngineHealthLeaseFacts {
     readonly lingerMs: number;
     readonly tickMs: number;
+    readonly firstAttach?: EngineHealthFirstAttachFacts;
+}
+export interface EngineHealthFirstAttachFacts {
+    readonly windowMs: number;
+    readonly since: number;
+    readonly attachedAt: number | null;
+}
+export interface EngineHealthInflightFacts {
+    readonly total: number;
+    readonly http?: number;
+    readonly leader?: number;
+    readonly sessionResident?: number;
+    readonly backgroundAgents?: number;
 }
 export interface EngineHealthFacts {
     readonly center?: EngineHealthCenterFacts;
@@ -24,5 +38,8 @@ export interface EngineHealthFacts {
     readonly operator?: 'present' | 'absent';
     readonly draining?: EngineHealthDrainingFacts;
     readonly engineLease?: EngineHealthLeaseFacts;
+    readonly inflight?: EngineHealthInflightFacts;
+    readonly version?: string;
+    readonly dataRoot?: string;
 }
 export declare function readEngineHealthFacts(health: object | null | undefined): EngineHealthFacts;

package/dist/engineHealthFacts.js

@@ -1,5 +1,5 @@
 import { readOwnDataValue } from './ownKey.js';
-const _healthFactsMatchSdk = [true, true, true, true, true, true];
+const _healthFactsMatchSdk = [true, true, true, true, true, true, true, true, true, true];
 void _healthFactsMatchSdk;
 const ENGINE_SIGNAL_KEY = 'engineSignal';
 function isObject(v) {
@@ -51,7 +51,10 @@ function authOf(raw) {
             return undefined;
         kinds.push(word);
     }
-    return Object.freeze({ required, kinds: Object.freeze(kinds), identityAttach });
+    const actsRaw = readOwnDataValue(raw, 'serviceTokenActsForDeployment');
+    if (actsRaw !== undefined && typeof actsRaw !== 'boolean')
+        return undefined;
+    return Object.freeze({ required, kinds: Object.freeze(kinds), identityAttach, ...(typeof actsRaw === 'boolean' ? { serviceTokenActsForDeployment: actsRaw } : {}) });
 }
 function drainingOf(health) {
     const signal = readOwnDataValue(health, ENGINE_SIGNAL_KEY);
@@ -67,6 +70,17 @@ function drainingOf(health) {
         return undefined;
     return Object.freeze({ actionId, since, deadlineAt });
 }
+function firstAttachOf(raw) {
+    if (!isObject(raw))
+        return undefined;
+    const windowMs = epochMs(readOwnDataValue(raw, 'windowMs'));
+    const since = epochMs(readOwnDataValue(raw, 'since'));
+    const attachedRaw = readOwnDataValue(raw, 'attachedAt');
+    const attachedAt = attachedRaw === null ? null : epochMs(attachedRaw);
+    if (windowMs === undefined || since === undefined || attachedAt === undefined)
+        return undefined;
+    return Object.freeze({ windowMs, since, attachedAt });
+}
 function leaseOf(raw) {
     if (!isObject(raw))
         return undefined;
@@ -74,7 +88,26 @@ function leaseOf(raw) {
     const tickMs = epochMs(readOwnDataValue(raw, 'tickMs'));
     if (lingerMs === undefined || tickMs === undefined)
         return undefined;
-    return Object.freeze({ lingerMs, tickMs });
+    const firstRaw = readOwnDataValue(raw, 'firstAttach');
+    const firstAttach = firstRaw === undefined ? undefined : firstAttachOf(firstRaw);
+    if (firstRaw !== undefined && firstAttach === undefined)
+        return undefined;
+    return Object.freeze({ lingerMs, tickMs, ...(firstAttach !== undefined ? { firstAttach } : {}) });
+}
+function inflightOf(health) {
+    const total = epochMs(readOwnDataValue(health, 'inflight'));
+    if (total === undefined)
+        return undefined;
+    const raw = guarded(() => readOwnDataValue(health, 'inflightBreakdown'));
+    const parts = {};
+    if (isObject(raw)) {
+        for (const key of ['http', 'leader', 'sessionResident', 'backgroundAgents']) {
+            const v = guarded(() => epochMs(readOwnDataValue(raw, key)));
+            if (v !== undefined)
+                parts[key] = v;
+        }
+    }
+    return Object.freeze({ total, ...parts });
 }
 function guarded(read) {
     try {
@@ -93,11 +126,17 @@ export function readEngineHealthFacts(health) {
     const operator = operatorRaw === 'present' || operatorRaw === 'absent' ? operatorRaw : undefined;
     const draining = guarded(() => drainingOf(health));
     const engineLease = guarded(() => leaseOf(readOwnDataValue(health, 'engineLease')));
+    const inflight = guarded(() => inflightOf(health));
+    const version = guarded(() => nonEmptyString(readOwnDataValue(health, 'version')));
+    const dataRoot = guarded(() => nonEmptyString(readOwnDataValue(health, 'dataRoot')));
     return Object.freeze({
         ...(center !== undefined ? { center } : {}),
         ...(auth !== undefined ? { auth } : {}),
         ...(operator !== undefined ? { operator } : {}),
         ...(draining !== undefined ? { draining } : {}),
         ...(engineLease !== undefined ? { engineLease } : {}),
+        ...(inflight !== undefined ? { inflight } : {}),
+        ...(version !== undefined ? { version } : {}),
+        ...(dataRoot !== undefined ? { dataRoot } : {}),
     });
 }

package/dist/engineNoticeCodes.d.ts

@@ -1,5 +1,6 @@
 import type { FinishReasonUnknownDetail } from '@sema-agent/sdk';
 import { CORE_TOOL_TURN_INCOMPLETE_CAUSES, CORE_USER_INPUT_UNDRAINED_CAUSES, CORE_USER_INPUT_UNDRAINED_FAMILIES } from './generated/engineNoticeTables.js';
+import { CORE_DISCARDED_DELIVERY_PATHS } from './generated/engineFactTables.js';
 import type { UiLanguage } from './env/uiLanguage.js';
 export type NoticeAudience = 'user' | 'operator';
 export declare const ENGINE_NOTICE_CODES: readonly string[];
@@ -14,9 +15,23 @@ export interface McpInjectionDropFactsView {
     field?: string;
 }
 export declare function readMcpInjectionDrop(notice: unknown): McpInjectionDropFactsView | undefined;
+export type NoticeLegView = {
+    readonly kind: 'self';
+} | {
+    readonly kind: 'delegated';
+    readonly sourceSessionId: string;
+    readonly agentId?: string;
+} | {
+    readonly kind: 'unreadable';
+};
+export declare function noticeCallSessionOf(facts: {
+    readonly sessionId?: string | undefined;
+    readonly leg: NoticeLegView;
+}): string | undefined;
 export declare const ASK_UNRESOLVABLE_CAUSES: readonly string[];
 export interface AskUnresolvableFactsView {
     sessionId: string;
+    leg: NoticeLegView;
     toolName: string;
     toolCallId: string;
     cause: string;
@@ -108,6 +123,7 @@ export interface ClassifierUnavailableFactsView {
     disposition: ClassifierUnavailableDispositionWord;
     sessionId?: string;
     runId?: string;
+    leg: NoticeLegView;
 }
 export declare function readClassifierUnavailable(notice: unknown): ClassifierUnavailableFactsView | undefined;
 export declare const PERMISSION_MODE_FOLD_REASONS: readonly string[];
@@ -129,6 +145,7 @@ export interface AskReleasedByModeFactsView {
     firstToolCallId: string;
     sessionId?: string;
     runId?: string;
+    leg: NoticeLegView;
 }
 export declare function readAskReleasedByMode(notice: unknown): AskReleasedByModeFactsView | undefined;
 export interface ReadDenyUnappliedFactsView {
@@ -139,6 +156,7 @@ export interface ReadDenyUnappliedFactsView {
     rowCount: number;
     sessionId: string;
     runId: string;
+    leg: NoticeLegView;
 }
 export declare function readReadDenyUnapplied(notice: unknown): ReadDenyUnappliedFactsView | undefined;
 export interface ToolTurnRepairView {
@@ -198,6 +216,7 @@ export interface UserInputUndrainedFactsView {
     runId?: string;
     childSessionId?: string;
     inputIds?: readonly string[];
+    inputKind?: 'steer' | 'approval_feedback';
 }
 export declare function readUserInputUndrained(notice: unknown): UserInputUndrainedFactsView | undefined;
 export interface UndrainedInputsLedger {
@@ -210,7 +229,7 @@ export interface UndrainedInputsVerdict {
     readonly unattributed: number;
 }
 export declare function undrainedInputsVerdict(facts: Pick<UserInputUndrainedFactsView, 'count' | 'cause' | 'inputIds' | 'childSessionId'> | null | undefined, ledger: UndrainedInputsLedger | null | undefined): UndrainedInputsVerdict | undefined;
-export declare function userInputUndrainedNotice(facts: Pick<UserInputUndrainedFactsView, 'kind' | 'count' | 'cause' | 'childSessionId'>): string | undefined;
+export declare function userInputUndrainedNotice(facts: Pick<UserInputUndrainedFactsView, 'kind' | 'count' | 'cause' | 'childSessionId' | 'inputKind'>, lang?: UiLanguage): string | undefined;
 export interface TurnInterruptedFactsView {
     lane: 'input_now' | 'user_halt' | 'unrecognized';
     inputId?: string;
@@ -270,6 +289,120 @@ interface SessionLineageRerootedBroken extends SessionLineageRerootedCommon {
 }
 export type SessionLineageRerootedFactsView = SessionLineageRerootedWhole | SessionLineageRerootedBroken;
 export declare function readSessionLineageRerooted(notice: {} | null | undefined): SessionLineageRerootedFactsView | undefined;
+export interface MemorySessionPollutedFactsView {
+    reason: string;
+    sessionId?: string;
+}
+export declare function readMemorySessionPolluted(notice: {} | null | undefined): MemorySessionPollutedFactsView | undefined;
+export interface MemoryHarvestQuarantinedFactsView {
+    count: number;
+    moved: number;
+    escalated: number;
+    indexRolledBack?: true;
+    reportId?: string;
+    sessionId?: string;
+}
+export declare function readMemoryHarvestQuarantined(notice: {} | null | undefined): MemoryHarvestQuarantinedFactsView | undefined;
+export interface MemoryDelegationStaticMarkWaivedFactsView {
+    reason: string;
+    subagentType?: string;
+    sessionId?: string;
+    runId: string;
+}
+export declare function readMemoryDelegationStaticMarkWaived(notice: {} | null | undefined): MemoryDelegationStaticMarkWaivedFactsView | undefined;
+export interface MemoryCaptureOptedOutFactsView {
+    sessionId: string;
+    origin: string;
+}
+export declare function readMemoryCaptureOptedOut(notice: {} | null | undefined): MemoryCaptureOptedOutFactsView | undefined;
+export interface MemoryCaptureOptoutUnpersistedFactsView {
+    sessionId: string;
+    ingress?: string;
+}
+export declare function readMemoryCaptureOptoutUnpersisted(notice: {} | null | undefined): MemoryCaptureOptoutUnpersistedFactsView | undefined;
+export interface PeerInboundDispositionFactsView {
+    disposition: string;
+    cause: string;
+    seq: number;
+    box: string;
+    fromSession?: string;
+    sessionId: string;
+    runId: string;
+}
+export declare function readPeerInboundDisposition(notice: {} | null | undefined): PeerInboundDispositionFactsView | undefined;
+export interface PeerHeldSettledFactsView {
+    settlement: string;
+    reason: string;
+    seq: number;
+    box: string;
+    fromSession?: string;
+    heldCount: number;
+    sessionId: string;
+    runId: string;
+}
+export declare function readPeerHeldSettled(notice: {} | null | undefined): PeerHeldSettledFactsView | undefined;
+export interface PeerIdleSubscriptionFactsView {
+    outcome: string;
+    fromSession: string;
+    live?: number;
+    seq: number;
+    box: string;
+    sessionId: string;
+    runId: string;
+}
+export declare function readPeerIdleSubscription(notice: {} | null | undefined): PeerIdleSubscriptionFactsView | undefined;
+export interface ClassifierDenialLimitFactsView {
+    sessionId: string;
+    runId: string;
+    toolName: string;
+    toolCallId: string;
+    consecutive: number;
+    total: number;
+    limit: string;
+}
+export declare function readClassifierDenialLimit(notice: {} | null | undefined): ClassifierDenialLimitFactsView | undefined;
+export interface TaskLateApprovalFactsView {
+    toolName: string;
+    toolCallId: string;
+    sessionId: string;
+    runId: string;
+    taskId?: string;
+}
+export declare function readTaskLateApproval(notice: {} | null | undefined): TaskLateApprovalFactsView | undefined;
+export interface TaskHaltUnconsumedFactsView {
+    sessionId: string;
+    runId: string;
+    taskId?: string;
+}
+export declare function readTaskHaltUnconsumed(notice: {} | null | undefined): TaskHaltUnconsumedFactsView | undefined;
+export interface SteeringParkedInputBlockedFactsView {
+    inputId?: string;
+    sessionId: string;
+    runId: string;
+    taskId?: string;
+}
+export declare function readSteeringParkedInputBlocked(notice: {} | null | undefined): SteeringParkedInputBlockedFactsView | undefined;
+export declare function memorySessionPollutedSentence(facts: Pick<MemorySessionPollutedFactsView, 'reason'>, lang?: UiLanguage): string | undefined;
+export declare function memoryHarvestQuarantinedSentence(facts: Pick<MemoryHarvestQuarantinedFactsView, 'count' | 'moved' | 'escalated' | 'indexRolledBack'>, lang?: UiLanguage): string | undefined;
+export declare function memoryDelegationStaticMarkWaivedSentence(facts: Pick<MemoryDelegationStaticMarkWaivedFactsView, 'reason' | 'subagentType'>, lang?: UiLanguage): string | undefined;
+export declare function memoryCaptureOptedOutSentence(facts: Pick<MemoryCaptureOptedOutFactsView, 'origin'>, lang?: UiLanguage): string | undefined;
+export declare function memoryCaptureOptoutUnpersistedSentence(facts: Pick<MemoryCaptureOptoutUnpersistedFactsView, 'sessionId' | 'ingress'>, lang?: UiLanguage): string | undefined;
+export declare function peerInboundDispositionSentence(facts: Pick<PeerInboundDispositionFactsView, 'disposition' | 'cause' | 'seq' | 'fromSession'>, lang?: UiLanguage): string | undefined;
+export declare function peerHeldSettledSentence(facts: Pick<PeerHeldSettledFactsView, 'settlement' | 'reason' | 'seq' | 'fromSession' | 'heldCount'>, lang?: UiLanguage): string | undefined;
+export declare function peerIdleSubscriptionSentence(facts: Pick<PeerIdleSubscriptionFactsView, 'outcome' | 'fromSession' | 'live'>, lang?: UiLanguage): string | undefined;
+export declare function classifierDenialLimitSentence(facts: Pick<ClassifierDenialLimitFactsView, 'toolName' | 'consecutive' | 'total' | 'limit'>, lang?: UiLanguage): string | undefined;
+export declare function taskLateApprovalSentence(facts: Pick<TaskLateApprovalFactsView, 'toolName'>, lang?: UiLanguage): string | undefined;
+export declare function taskHaltUnconsumedSentence(facts: Pick<TaskHaltUnconsumedFactsView, 'sessionId' | 'runId'>, lang?: UiLanguage): string | undefined;
+export declare function steeringParkedInputBlockedSentence(facts: Pick<SteeringParkedInputBlockedFactsView, 'sessionId' | 'runId'>, lang?: UiLanguage): string | undefined;
+export declare function durableGateUnavailableSentence(facts: Pick<DurableGateUnavailableFactsView, 'source' | 'cause' | 'liveApprover' | 'liveQuestionFace'>, lang?: UiLanguage): string | undefined;
+export type DiscardedDeliveryPathWord = (typeof CORE_DISCARDED_DELIVERY_PATHS)[number];
+export interface DeliveryDiscardedFactsView {
+    taskId: string;
+    taskType: string;
+    sessionId: string;
+    path?: DiscardedDeliveryPathWord;
+}
+export declare function readDeliveryDiscarded(notice: {} | null | undefined): DeliveryDiscardedFactsView | undefined;
 export declare const ENGINE_NOTICE_FACT_READERS: Readonly<{
     readonly 'mcp.injection_dropped': typeof readMcpInjectionDrop;
     readonly 'delegation.ask_unresolvable': typeof readAskUnresolvable;
@@ -298,6 +431,19 @@ export declare const ENGINE_NOTICE_FACT_READERS: Readonly<{
     readonly 'context.media_removed': typeof readContextMediaRemoved;
     readonly 'context.image_removed': typeof readContextMediaRemoved;
     readonly 'session.lineage_rerooted': typeof readSessionLineageRerooted;
+    readonly 'memory.session_polluted': typeof readMemorySessionPolluted;
+    readonly 'memory.harvest_quarantined': typeof readMemoryHarvestQuarantined;
+    readonly 'memory.delegation_static_mark_waived': typeof readMemoryDelegationStaticMarkWaived;
+    readonly 'memory.capture_opted_out': typeof readMemoryCaptureOptedOut;
+    readonly 'memory.capture_optout_unpersisted': typeof readMemoryCaptureOptoutUnpersisted;
+    readonly 'peer.inbound_disposition': typeof readPeerInboundDisposition;
+    readonly 'peer.held_settled': typeof readPeerHeldSettled;
+    readonly 'peer.idle_subscription': typeof readPeerIdleSubscription;
+    readonly 'classifier.denial_limit': typeof readClassifierDenialLimit;
+    readonly 'task.late_approval': typeof readTaskLateApproval;
+    readonly 'task.halt_unconsumed': typeof readTaskHaltUnconsumed;
+    readonly 'steering.parked_input_blocked': typeof readSteeringParkedInputBlocked;
+    readonly 'delegation.delivery_discarded': typeof readDeliveryDiscarded;
 }>;
 type FactReaderTable = typeof ENGINE_NOTICE_FACT_READERS;
 export type EngineNoticeFactsCode = keyof FactReaderTable;