@sema-agent/client-core 0.106.0 → 0.108.0

package/dist/displayUntrusted.js

@@ -957,13 +957,14 @@ function hiddenHostEnd(text, from, unitAt) {
     const c = text.charCodeAt(k);
     return endsSchemelessHost(c) || c === 0x40 ? k : -1;
 }
+const IDEOGRAPHIC_SPACE = 0x3000;
 const NAME_BLANK_RANGES = [
     [0x00a0, 0x00a0],
     [0x1680, 0x1680],
     [0x2000, 0x200a],
     [0x202f, 0x202f],
     [0x205f, 0x205f],
-    [0x3000, 0x3000],
+    [IDEOGRAPHIC_SPACE, IDEOGRAPHIC_SPACE],
     [0x115f, 0x1160],
     [0x3164, 0x3164],
     [0xffa0, 0xffa0],
@@ -3593,7 +3594,7 @@ const FACE_MARKED_CHAR = new RegExp(`^(?:[${C0_ALL}${DEL_C1}${LONE_SURROGATE}${L
 const isStrippableControl = (c) => (c <= 0x1f && (c < 0x09 || c > 0x0d)) || (c >= 0x7f && c <= 0x9f);
 class SequenceReader {
     text;
-    atomicBlanks;
+    blanks;
     foldBlanks;
     terminator;
     lineBreak;
@@ -3602,9 +3603,9 @@ class SequenceReader {
     breakFrom = -1;
     breakAt = -1;
     foldSpaces;
-    constructor(text, atomicBlanks, foldBlanks = false, foldSpaces = false) {
+    constructor(text, blanks, foldBlanks = false, foldSpaces = false) {
         this.text = text;
-        this.atomicBlanks = atomicBlanks;
+        this.blanks = blanks;
         this.foldBlanks = foldBlanks;
         this.foldSpaces = foldSpaces;
         this.terminator = /[\u0007\u009c]|\u001b\\|\\u(?:0007|009[cC]|001[bB]\\)/g;
@@ -3615,12 +3616,7 @@ class SequenceReader {
             return false;
         if (escapeTokenAt(this.text, at) !== null)
             return true;
-        if (this.atomicBlanks === 'none')
-            return false;
-        const cp = nameBlankTokenAt(this.text, at);
-        if (this.atomicBlanks === 'fillers')
-            return cp !== -1 && !isFoldedBlank(cp);
-        return this.atomicBlanks === 'all' ? cp !== -1 : isFoldedBlank(cp);
+        return isMarkedNameBlank(this.blanks, nameBlankTokenAt(this.text, at));
     }
     intermediateAt(at) {
         const c = this.text.charCodeAt(at);
@@ -3628,11 +3624,12 @@ class SequenceReader {
             return 1;
         if (this.foldSpaces && ((c >= 0x09 && c <= 0x0d) || c === 0x2028 || c === 0x2029))
             return 1;
-        if (!this.foldBlanks)
-            return 0;
-        if (isFoldedBlank(c))
+        if (this.blankAsSpace(c))
             return 1;
-        return c === 0x5c && isFoldedBlank(nameBlankTokenAt(this.text, at)) ? 6 : 0;
+        return c === 0x5c && this.blankAsSpace(nameBlankTokenAt(this.text, at)) ? 6 : 0;
+    }
+    blankAsSpace(cp) {
+        return isFoldedBlank(cp) && (this.foldBlanks || isMarkedNameBlank(this.blanks, cp));
     }
     interruptsAt(at) {
         if (at >= this.text.length)
@@ -3738,7 +3735,7 @@ function nameBlankTokenAt(text, at) {
     return isNameBlank(cp) ? cp : -1;
 }
 function isMarkedNameBlank(net, c) {
-    return net === 1 ? isNameBlank(c) : net === 2 ? isNameBlank(c) && !isRegexSpace(c) : false;
+    return net === 1 ? isNameBlank(c) : net === 2 ? isNameBlank(c) && c !== IDEOGRAPHIC_SPACE : false;
 }
 function buildScanView(text, o) {
     const chars = [];
@@ -3748,7 +3745,7 @@ function buildScanView(text, o) {
     const dropped = [];
     const spaceUnits = [];
     const contents = [];
-    const seq = new SequenceReader(text, o.blanks === 1 ? 'all' : o.blanks === 2 ? 'fillers' : 'none', o.blanks === 1 || o.fold, o.fold);
+    const seq = new SequenceReader(text, o.blanks, o.fold, o.fold);
     const keep = (ch, s, e, unit = UNIT_NONE) => {
         chars.push(ch);
         starts.push(s);
@@ -3945,7 +3942,7 @@ function screenSurfaces(text, o) {
     if (face === null)
         return { surfaces: [], rawSoft: null, rawPlain: null, contents: [] };
     const unsafe = face.unsafe === null ? null : new RegExp(face.unsafe.source, 'u');
-    const keepBlanks = face.keepBlanks === true;
+    const blankNet = face.blanks ?? 0;
     const chars = [];
     const ps = [];
     const pe = [];
@@ -3955,7 +3952,7 @@ function screenSurfaces(text, o) {
     let changed = false;
     const foldable = (at) => {
         const c = text.codePointAt(at) ?? 0;
-        return isRegexSpace(c) && !(keepBlanks && isNameBlank(c));
+        return isRegexSpace(c) && !isMarkedNameBlank(blankNet, c);
     };
     let lo = 0;
     let hi = text.length;
@@ -4648,7 +4645,7 @@ export function washCredentials(text) {
     return scanAndMask(text, WASH_OPTIONS, false).text;
 }
 const NAME_BLANKS = NAME_BLANK_RANGES.map(([a, b]) => (a === b ? classEscape(a) : `${classEscape(a)}-${classEscape(b)}`)).join('');
-const NAME_FILLERS = NAME_BLANK_RANGES.filter(([a, b]) => !isRegexSpace(a) && !isRegexSpace(b))
+const NAME_BLANKS_EXCEPT_IDEOGRAPHIC = NAME_BLANK_RANGES.filter(([a, b]) => !(a <= IDEOGRAPHIC_SPACE && IDEOGRAPHIC_SPACE <= b))
     .map(([a, b]) => (a === b ? classEscape(a) : `${classEscape(a)}-${classEscape(b)}`))
     .join('');
 function classEscape(cp) {
@@ -4777,17 +4774,17 @@ function markOf(ch, mark) {
     return code > 0xffff ? `\\u{${hex}}` : `\\u${hex.padStart(4, '0')}`;
 }
 const FOLD_RUN = /\s+/g;
-const FOLD_RUN_KEEPING_BLANKS = new RegExp(`[^\\S${NAME_BLANKS}]+`, 'g');
+const FOLD_RUN_BY_NET = [FOLD_RUN, new RegExp(`[^\\S${NAME_BLANKS}]+`, 'g'), new RegExp(`[^\\S${NAME_BLANKS_EXCEPT_IDEOGRAPHIC}]+`, 'g')];
 const EDGE_SPACE = /^ | $/g;
-const foldWhitespace = (s, keepBlanks = false) => keepBlanks ? s.replace(FOLD_RUN_KEEPING_BLANKS, ' ').replace(EDGE_SPACE, '') : s.replace(FOLD_RUN, ' ').trim();
+const foldWhitespace = (s, net = 0) => net !== 0 ? s.replace(FOLD_RUN_BY_NET[net] ?? FOLD_RUN, ' ').replace(EDGE_SPACE, '') : s.replace(FOLD_RUN, ' ').trim();
 export function applyDisplayFace(text, face) {
     const markAll = (s) => face.unsafe === null ? s : s.replace(face.unsafe, (ch, at, whole) => (faceHitKept(ch, at, whole, face.keepCrlf === true) ? ch : markOf(ch, face.mark)));
-    const keepBlanks = face.keepBlanks === true;
+    const net = face.blanks ?? 0;
     if (face.mark === 'space') {
         const marked = markAll(text);
-        return face.fold ? foldWhitespace(marked, keepBlanks) : marked;
+        return face.fold ? foldWhitespace(marked, net) : marked;
     }
-    return markAll(face.fold ? foldWhitespace(text, keepBlanks) : text);
+    return markAll(face.fold ? foldWhitespace(text, net) : text);
 }
 function markTracked(t, re, mark, ledger, crlf = false) {
     const parts = [];
@@ -4820,11 +4817,11 @@ function markTracked(t, re, mark, ledger, crlf = false) {
     keep(cursor, t.text.length);
     return { text: parts.join(''), ids: Int32Array.from(ids) };
 }
-function foldTracked(t, keepBlanks) {
+function foldTracked(t, net) {
     const parts = [];
     const ids = [];
     let cursor = 0;
-    for (const run of t.text.matchAll(keepBlanks ? FOLD_RUN_KEEPING_BLANKS : FOLD_RUN)) {
+    for (const run of t.text.matchAll(FOLD_RUN_BY_NET[net] ?? FOLD_RUN)) {
         const at = run.index ?? 0;
         parts.push(t.text.slice(cursor, at));
         for (let k = cursor; k < at; k++)
@@ -4849,14 +4846,14 @@ function foldTracked(t, keepBlanks) {
     return { text: folded.slice(from, to), ids: Int32Array.from(ids.slice(from, to)) };
 }
 function faceTracked(t, face, ledger) {
-    const keepBlanks = face.keepBlanks === true;
+    const net = face.blanks ?? 0;
     const unsafe = face.unsafe;
     const markAll = (x) => (unsafe === null ? x : markTracked(x, unsafe, face.mark, ledger, face.keepCrlf === true));
     if (face.mark === 'space') {
         const marked = markAll(t);
-        return face.fold ? foldTracked(marked, keepBlanks) : marked;
+        return face.fold ? foldTracked(marked, net) : marked;
     }
-    return markAll(face.fold ? foldTracked(t, keepBlanks) : t);
+    return markAll(face.fold ? foldTracked(t, net) : t);
 }
 function carryIds(ids, origin) {
     if (origin === undefined)
@@ -4933,7 +4930,7 @@ function collectMarks(t, ledger) {
 export const DISPLAY_DECISION_BODY = Object.freeze({
     foldLines: false,
     keepLayout: 'crlf',
-    blanks: 'fillers',
+    blanks: 'except-ideographic',
     mark: 'escape',
 });
 const PUBLIC_UNSAFE_BY_NETS = Object.freeze(Array.from({ length: 24 }, (_, i) => {
@@ -4942,12 +4939,12 @@ const PUBLIC_UNSAFE_BY_NETS = Object.freeze(Array.from({ length: 24 }, (_, i) =>
     const controls = (rest & 4) !== 0;
     const bidi = (rest & 2) !== 0;
     const keep = (rest & 1) !== 0;
-    const blanks = net === 1 ? NAME_BLANKS : net === 2 ? NAME_FILLERS : '';
+    const blanks = net === 1 ? NAME_BLANKS : net === 2 ? NAME_BLANKS_EXCEPT_IDEOGRAPHIC : '';
     const members = `${controls ? `${keep ? C0_KEEP_LAYOUT : C0_ALL}${DEL_C1}${LONE_SURROGATE}` : ''}${bidi ? LINE_SEPARATORS : ''}${blanks}`;
     return unsafeClass(members, bidi);
 }));
 function blankNetOf(opts) {
-    return opts.blanks === true ? 1 : opts.blanks === 'fillers' ? 2 : 0;
+    return opts.blanks === true ? 1 : opts.blanks === 'except-ideographic' ? 2 : 0;
 }
 const keepsLayout = (opts) => opts.keepLayout === true || opts.keepLayout === 'crlf';
 function publicFace(opts) {
@@ -4955,7 +4952,7 @@ function publicFace(opts) {
     const keep = !fold && keepsLayout(opts);
     const net = blankNetOf(opts);
     const index = ((opts.controls !== false ? 4 : 0) + (opts.bidi !== false ? 2 : 0) + (keep ? 1 : 0)) * 3 + net;
-    const face = { unsafe: PUBLIC_UNSAFE_BY_NETS[index] ?? null, fold, mark: opts.mark ?? 'escape', keepBlanks: net === 1 };
+    const face = { unsafe: PUBLIC_UNSAFE_BY_NETS[index] ?? null, fold, mark: opts.mark ?? 'escape', blanks: net };
     return keep && opts.keepLayout === 'crlf' && opts.controls !== false ? { ...face, keepCrlf: true } : face;
 }
 export const ESCAPE_FACE = Object.freeze({ ...publicFace({ foldLines: false }) });
@@ -5074,13 +5071,22 @@ function displayInputText(text) {
             return text === null ? '' : REDACTED_SECRET;
     }
 }
+const ENCODED_FORM = /\\\\|\\u(?:[0-9A-Fa-f]{4}|\{[0-9A-Fa-f]{1,6}\})/;
+function pairsByItself(form) {
+    return ENCODED_FORM.test(form.text);
+}
+function pairModeOf(o, face) {
+    if (face.mark === 'dot' || face.mark === 'space')
+        return 'off';
+    return o.escapeBackslashes === true ? 'on' : o.escapeBackslashes === 'auto' ? 'auto' : 'off';
+}
 function renderUntrusted(text, opts, ledger, queryByShape = false, wholeAddress = false) {
     const input = displayInputText(text);
     const o = opts ?? {};
     const face = publicFace(o);
     const scan = scanOptionsOf(o, face, queryByShape, wholeAddress);
-    const pairBackslashes = o.escapeBackslashes === true && face.mark !== 'dot' && face.mark !== 'space';
-    const book = ledger ?? (pairBackslashes ? { cps: [], lens: [] } : null);
+    const mode = pairModeOf(o, face);
+    const book = ledger ?? (mode !== 'off' ? { cps: [], lens: [] } : null);
     if (book === null) {
         return runDisplaySteps(input, {
             wash: (s) => scanAndMask(s, scan, false).text,
@@ -5089,6 +5095,7 @@ function renderUntrusted(text, opts, ledger, queryByShape = false, wholeAddress
             text: (s) => s,
         });
     }
+    let paired = mode === 'on';
     const out = runDisplaySteps({ text: input, ids: new Int32Array(input.length).fill(-1) }, {
         wash: (t) => {
             const r = scanAndMask(t.text, scan, true);
@@ -5096,18 +5103,20 @@ function renderUntrusted(text, opts, ledger, queryByShape = false, wholeAddress
         },
         paint: (t) => faceTracked(t, face, book),
         cap: (t) => {
-            if (pairBackslashes)
+            if (mode === 'auto' && !paired)
+                paired = pairsByItself(t);
+            if (paired)
                 return capPaired(t, o.max);
             const cut = capDisplay(t.text, o.max, face.mark);
             return cut === t.text ? t : { text: cut, ids: t.ids.slice(0, cut.length) };
         },
         text: (t) => t.text,
     });
-    return pairBackslashes ? pairLiteralBackslashes(out) : out;
+    return { tracked: paired ? pairLiteralBackslashes(out) : out, exact: paired };
 }
 export function displayUntrusted(text, opts = {}) {
     const out = renderUntrusted(text, opts, null);
-    return typeof out === 'string' ? out : out.text;
+    return typeof out === 'string' ? out : out.tracked.text;
 }
 export function cleanUntrustedScalar(v) {
     return displayUntrusted(String(v ?? ''), { credentialUrls: false, credentialWords: false, foldLines: false });
@@ -5354,7 +5363,7 @@ export function queryCarriesCredential(query) {
 export function displayConfiguredUrl(url, opts = {}) {
     const reading = typeof url === 'string' ? configuredAddressReading(url) : null;
     const out = renderUntrusted(reading === null ? url : reading.withheld ? REDACTED_SECRET : reading.text, opts, null, 'relaxed', true);
-    return typeof out === 'string' ? out : out.text;
+    return typeof out === 'string' ? out : out.tracked.text;
 }
 function parserViewOf(url) {
     return url.replace(/[\t\n\r]/g, '').replace(/^[\u0000-\u0020]+/, '');
@@ -5773,7 +5782,7 @@ export function displayUntrustedMarks(text, opts = {}) {
     const ledger = { cps: [], lens: [] };
     const out = renderUntrusted(text, opts, ledger);
     if (typeof out === 'string')
-        return { text: out, marks: [] };
-    return { text: out.text, marks: collectMarks(out, ledger) };
+        return { text: out, marks: [], exact: false };
+    return { text: out.tracked.text, marks: collectMarks(out.tracked, ledger), exact: out.exact };
 }
 const isQuoteChar = (c) => c.charCodeAt(0) === 0x22 || c.charCodeAt(0) === 0x27;

package/dist/engineErrorCodes.d.ts

@@ -99,6 +99,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

@@ -177,6 +177,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/engineNoticeCodes.d.ts

@@ -14,9 +14,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 +122,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 +144,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 +155,7 @@ export interface ReadDenyUnappliedFactsView {
     rowCount: number;
     sessionId: string;
     runId: string;
+    leg: NoticeLegView;
 }
 export declare function readReadDenyUnapplied(notice: unknown): ReadDenyUnappliedFactsView | undefined;
 export interface ToolTurnRepairView {
@@ -197,9 +214,21 @@ export interface UserInputUndrainedFactsView {
     sessionId?: string;
     runId?: string;
     childSessionId?: string;
+    inputIds?: readonly string[];
+    inputKind?: 'steer' | 'approval_feedback';
 }
 export declare function readUserInputUndrained(notice: unknown): UserInputUndrainedFactsView | undefined;
-export declare function userInputUndrainedNotice(facts: Pick<UserInputUndrainedFactsView, 'kind' | 'count' | 'cause' | 'childSessionId'>): string | undefined;
+export interface UndrainedInputsLedger {
+    readonly handed?: readonly string[];
+    readonly redelivered?: readonly string[];
+}
+export interface UndrainedInputsVerdict {
+    readonly redeliver: readonly string[];
+    readonly askUser: readonly string[];
+    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' | 'inputKind'>, lang?: UiLanguage): string | undefined;
 export interface TurnInterruptedFactsView {
     lane: 'input_now' | 'user_halt' | 'unrecognized';
     inputId?: string;
@@ -285,6 +314,7 @@ export declare const ENGINE_NOTICE_FACT_READERS: Readonly<{
     readonly 'route.stream_end_ignored': typeof readStreamEndIgnored;
     readonly 'mcp.authorization_required': typeof readMcpAuthorizationRequired;
     readonly 'context.media_removed': typeof readContextMediaRemoved;
+    readonly 'context.image_removed': typeof readContextMediaRemoved;
     readonly 'session.lineage_rerooted': typeof readSessionLineageRerooted;
 }>;
 type FactReaderTable = typeof ENGINE_NOTICE_FACT_READERS;