@sema-agent/client-core 0.82.6 → 0.83.0

package/dist/adapter/downstream/eventToSdkMessage.js

@@ -161,7 +161,7 @@ export function eventToSdkMessage(ev, ctx) {
                         : {}),
                     ...(freedTokens !== undefined ? { _sema_freed_tokens: freedTokens } : {}),
                 },
-                ...(Array.isArray(attachedFiles) && attachedFiles.length > 0 ? { attachedFiles } : {}),
+                ...(Array.isArray(attachedFiles) && attachedFiles.length > 0 ? { _sema_attached_files: attachedFiles } : {}),
             })));
         }
         case 'tool_end': {

package/dist/adapter/downstream/terminalToSdkResult.d.ts

@@ -1,6 +1,7 @@
 import type { AgentEvent, DeniedBy, TaskStats } from '@sema-agent/sdk';
 import { type CcToolDenialKind } from '../../gateVocabulary.js';
 import { type SDKMessage, type EmitContext } from '../types.js';
+import type { TerminalReason } from '@sema-agent/agent-types';
 import { type SemaModelUsage } from './turnUsageToModelUsage.js';
 export interface SemaFlatUsage {
     readonly inputTokens: number;
@@ -90,15 +91,12 @@ export declare function subagentUsageIsPartial(row: {
 } | null | undefined, opts?: {
     readonly tablePartial?: boolean;
 }): boolean;
-export interface SemaNestedUsageByTask {
-    readonly rows: Readonly<Record<string, SemaSubagentUsageRow>>;
-    readonly partial: boolean;
-}
 export interface SemaTerminalModelUsage extends SemaModelUsage {
     readonly _sema_total_input_tokens?: number;
     readonly _sema_usage_basis?: string;
     readonly _sema_cache_write_tokens_long?: number;
 }
+export declare function terminalReasonForResult(msg: SDKMessage): TerminalReason | undefined;
 export declare function doneToSdkResult(ev: Extract<AgentEvent, {
     type: 'done';
 }>, ctx: EmitContext, observed?: TerminalStreamObserved): SDKMessage;

package/dist/adapter/downstream/terminalToSdkResult.js

@@ -413,6 +413,41 @@ function subtypeForErrorCode(code) {
         return 'error_max_structured_output_retries';
     return 'error_during_execution';
 }
+function terminalReasonOf(subtype, isError) {
+    switch (subtype) {
+        case 'success':
+            return isError === false ? 'completed' : undefined;
+        case 'error_max_turns':
+            return 'max_turns';
+        case 'error_max_budget_usd':
+            return 'budget_exhausted';
+        case 'error_max_structured_output_retries':
+            return 'structured_output_retry_exhausted';
+        default:
+            return undefined;
+    }
+}
+function terminalReasonParts(subtype, isError) {
+    const reason = terminalReasonOf(subtype, isError);
+    return reason !== undefined ? { terminal_reason: reason } : {};
+}
+export function terminalReasonForResult(msg) {
+    try {
+        const m = msg;
+        if (typeof m !== 'object' || m === null || Array.isArray(m))
+            return undefined;
+        const rec = m;
+        if (rec.type !== 'result')
+            return undefined;
+        return terminalReasonOf(rec.subtype, rec.is_error);
+    }
+    catch {
+        return undefined;
+    }
+}
+function selectedModelParts(model) {
+    return typeof model === 'string' && model.length > 0 ? { _sema_selected_model: model } : {};
+}
 function salvagedTextOf(r) {
     const salvagedOutput = r.salvagedOutput;
     return typeof r.result === 'string' && r.result.trim().length > 0
@@ -449,9 +484,11 @@ function errorResult(ctx, parts) {
         ...reemitEffectiveFacts(parts.facts),
         ...nestedUsageByTaskParts(parts.stats, parts.observed?.nestedUsageByTask),
         errors: [...parts.errors],
-        ...(parts.errorCode !== undefined && parts.errorCode.length > 0 ? { errorCode: parts.errorCode } : {}),
-        ...(parts.degraded !== undefined ? { degraded: parts.degraded } : {}),
-        ...(parts.salvagedResult !== undefined ? { result: parts.salvagedResult } : {}),
+        ...terminalReasonParts(parts.subtype, true),
+        ...(parts.errorCode !== undefined && parts.errorCode.length > 0 ? { _sema_error_code: parts.errorCode } : {}),
+        ...(parts.degraded !== undefined ? { _sema_model_degraded: parts.degraded } : {}),
+        ...selectedModelParts(parts.model),
+        ...(parts.salvagedResult !== undefined ? { _sema_salvaged_result: parts.salvagedResult } : {}),
         ...(parts.outcomeUnknown === true ? { _sema_outcome: 'unknown' } : {}),
     });
 }
@@ -556,16 +593,17 @@ export function doneToSdkResult(ev, ctx, observed) {
         num_turns: stats?.turns ?? 0,
         result: r.result ?? '',
         ...structuredOutputParts(r),
-        ...(degraded !== undefined ? { degraded } : {}),
+        ...(degraded !== undefined ? { _sema_model_degraded: degraded } : {}),
         stop_reason: null,
         total_cost_usd: costOrNull(stats),
         usage: flattenUsage(stats),
         modelUsage: modelUsageFor(stats, r.model),
         ...permissionDenialParts(stats, observed),
+        ...terminalReasonParts('success', false),
         ...costFactParts(stats, observed),
         ...effectiveFactParts(rec),
         ...nestedUsageByTaskParts(stats, observed?.nestedUsageByTask),
-        ...(typeof r.model === 'string' ? { model: r.model } : {}),
+        ...selectedModelParts(r.model),
     });
 }
 export function failedToSdkResult(ev, ctx, observed) {

package/dist/adapter/runStream.js

@@ -1,4 +1,4 @@
-import { eventSeq, } from './types.js';
+import { eventSeq, stamp, } from './types.js';
 import { eventToSdkMessage, turnEndUsage } from './downstream/eventToSdkMessage.js';
 import { turnUsageToModelUsage } from './downstream/turnUsageToModelUsage.js';
 import { readRunCostFacts, terminalToSdkResult, TOOL_INPUT_JOIN_MAX_CALLS } from './downstream/terminalToSdkResult.js';
@@ -97,14 +97,14 @@ export function isModelOutputErrorRowText(text) {
 }
 export const OUTCOME_UNKNOWN_ROW_PREFIX = 'Outcome unknown';
 function syntheticTerminalRow(ctx, text) {
-    return {
-        session_id: ctx.sessionId ?? '',
-        uuid: `err-${Date.now().toString(36)}`,
+    return stamp(ctx, {
+        uuid: undefined,
+        session_id: undefined,
         type: 'assistant',
         message: { role: 'assistant', model: '<synthetic>', content: [{ type: 'text', text }] },
         parent_tool_use_id: null,
-        isApiErrorMessage: true,
-    };
+        _sema_api_error_message: true,
+    });
 }
 export function isOutcomeUnknownRowText(text) {
     return text.trimStart().startsWith(`${OUTCOME_UNKNOWN_ROW_PREFIX}:`);

package/dist/clientSlice.d.ts

@@ -1,8 +1,3 @@
-export interface ClientVerbSpec {
-    verb: string;
-    required: boolean;
-    duty: string;
-}
 export interface ClientSliceLike {
     streamTask(req: unknown, opts?: {
         signal?: {

package/dist/engineNoticeCodes.js

@@ -3,6 +3,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'config.env_timeout_discarded',
     'config.materialize_env_discarded',
     'config.models_swapped',
+    'config.context_settings_swapped',
     'config.read_face_swapped',
     'config.read_face_deployment_clamped',
     'config.write_face_swapped',
@@ -22,6 +23,7 @@ export const ENGINE_NOTICE_CODES = Object.freeze([
     'config.durable_gate_unavailable',
     'config.peer_admission_out_of_range',
     'config.peer_lane_unmounted',
+    'config.secret_env_scrubbed',
     'peer.inbound_disposition',
     'peer.held_settled',
     'peer.idle_subscription',
@@ -78,6 +80,7 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'config.env_timeout_discarded': 'operator',
     'config.materialize_env_discarded': 'operator',
     'config.models_swapped': 'operator',
+    'config.context_settings_swapped': 'operator',
     'config.read_face_swapped': 'operator',
     'config.read_face_deployment_clamped': 'operator',
     'config.write_face_swapped': 'operator',
@@ -97,6 +100,7 @@ export const ENGINE_NOTICE_AUDIENCE = Object.freeze({
     'config.durable_gate_unavailable': 'user',
     'config.peer_admission_out_of_range': 'operator',
     'config.peer_lane_unmounted': 'operator',
+    'config.secret_env_scrubbed': 'operator',
     'peer.inbound_disposition': 'user',
     'peer.held_settled': 'user',
     'peer.idle_subscription': 'user',

package/dist/fleet/fleetRowAgentType.d.ts

@@ -1,3 +1,2 @@
 export declare function recordFleetRowAgentType(taskIdTail: string, agentType: string | undefined): void;
 export declare function fleetRowAgentType(taskIdTail: string | undefined): string | undefined;
-export declare function __resetFleetRowAgentTypeForTests(): void;

package/dist/fleet/fleetRowAgentType.js

@@ -23,6 +23,3 @@ export function fleetRowAgentType(taskIdTail) {
     agentTypeByTail.set(taskIdTail, v);
     return v;
 }
-export function __resetFleetRowAgentTypeForTests() {
-    agentTypeByTail.clear();
-}

package/dist/hitl/approvalResolution.js

@@ -70,6 +70,8 @@ function fsLegResolution(outcome, kind) {
     }
     if (stage === 'input')
         return { kind: 'not_sent', cause: 'no_input', ...call, ...detail };
+    if (stage === 'card' && pick(outcome, 'editRefused') === true)
+        return { kind: 'not_sent', cause: 'edit_refused', ...call, ...detail };
     if (stage === 'card')
         return { kind: 'not_sent', cause: 'card_unavailable', ...call, ...detail };
     if (stage === 'decide') {

package/dist/hitl/frameRouter.d.ts

@@ -24,7 +24,7 @@ export interface AskGateWireDeps {
     onToolApprovalOutcome?: (frame: ToolApprovalFrame, outcome: ToolApprovalFrameOutcome) => void | Promise<void>;
     onDecideOperation?: DecideOperationObserver;
 }
-export type GateKind = 'ask' | 'fs';
+type GateKind = 'ask' | 'fs';
 export interface GatePark {
     gate: GateKind;
     pendingDone?: AgentEvent | undefined;
@@ -55,10 +55,11 @@ export interface FrameRouterCtx {
 }
 export declare function isAskTool(toolName: string | undefined): boolean;
 export declare function isHostProgressFrame(ev: AgentEvent): boolean;
-export interface HeldFlushInterruptEvidence {
+interface HeldFlushInterruptEvidence {
     terminal?: AgentEvent | undefined;
     signal?: AbortSignal | undefined;
     gateAbortedByUser?: boolean | undefined;
 }
 export declare function flushHeldWithInterruptRewrite(led: GateLedger, evidence: HeldFlushInterruptEvidence): Generator<AgentEvent>;
 export declare function routeFrame(ev: AgentEvent, ctx: FrameRouterCtx): Promise<FrameAction>;
+export {};

package/dist/hitl/toolApprovalWire.d.ts

@@ -39,6 +39,7 @@ export type FsApprovalOutcome = {
     retryExhausted?: true;
     currentPending?: GateCurrentPending | undefined;
     denyAttributionRefusal?: DenyAttributionRefusalDetail | undefined;
+    editRefused?: true;
 };
 export interface FsApprovalWireDeps {
     client: HitlClientLike;

package/dist/hitl/toolApprovalWire.js

@@ -140,15 +140,46 @@ function logAfterDecided(msg) {
     catch {
     }
 }
+const ARGS_OMITTED_PATH_RECOVERED_NOTE = 'tool arguments exceeded the wire cap and were omitted — only the target path was recovered (from the approval question); ' +
+    'the rest of the arguments, such as the content to write, is not shown, so you are deciding without seeing it. ' +
+    'Edits are not accepted on this card: there is no original input to edit';
+const ARGS_OMITTED_NOTHING_RECOVERED_NOTE = 'tool arguments exceeded the wire cap and were omitted, and nothing could be recovered from the approval question — ' +
+    'you are deciding without seeing what this call will do; deny it if you are not sure. ' +
+    'Edits are not accepted on this card: there is no original input to edit';
+const PARK_ROW_ARGS_ABSENT_NOTE = "this request's tool arguments are not available on this surface — neither the event stream nor the pending approval record " +
+    'carries them, so you are deciding without seeing them; deny it if you are not sure what it will do. ' +
+    'Edits are not accepted on this card: there is no original input to edit';
+const PARK_ROW_ARGS_TRUNCATED_NOTE = "this request's tool arguments were too large to keep on the pending approval record and were replaced by a size marker, " +
+    'so you are deciding without seeing them; deny it if you are not sure what it will do. ' +
+    'Edits are not accepted on this card: there is no original input to edit';
+const PARK_EDIT_REFUSED_REASON = "the card returned an edited approval, but this request's tool arguments are not available on this surface " +
+    '(missing, or replaced by a size marker on the pending approval record), so the edit cannot be applied — nothing was sent; ' +
+    'approve or deny it as it is';
+function isParkRowInputSizeMarker(v) {
+    if (typeof v !== 'object' || v === null || Array.isArray(v))
+        return false;
+    const keys = Object.keys(v);
+    if (keys.length !== 2 || !keys.includes('truncated') || !keys.includes('bytes'))
+        return false;
+    const o = v;
+    return o.truncated === true && typeof o.bytes === 'number' && Number.isFinite(o.bytes) && o.bytes >= 0;
+}
 export async function surfaceFsApprovalAndDecide(deps, taskId, argsByCall, signal, parkGatedCallId) {
     const found = await findPendingForTask(deps.client, taskId, (toolName) => toolName !== undefined && (toolNameIsFsWrite(toolName) || toolNameIsShellExec(toolName)), signal ? { signal } : undefined, parkGatedCallId, (row) => askParkRowArm(row) === 'tool-gate');
     if (!found.ok)
         return { kind: 'failed', stage: 'fetch', reason: found.reason, ...(found.code !== undefined ? { code: found.code } : {}) };
     const { pending, gatedCallId } = found;
     const toolName = typeof pending.toolName === 'string' ? pending.toolName : '';
-    const args = (gatedCallId !== undefined ? argsByCall.get(gatedCallId) : undefined) ??
-        pending.input ??
-        {};
+    const streamArgs = gatedCallId !== undefined ? argsByCall.get(gatedCallId) : undefined;
+    const rowInput = pending.input;
+    const rowArgsGap = streamArgs !== undefined && streamArgs !== null
+        ? undefined
+        : rowInput === undefined || rowInput === null
+            ? 'absent'
+            : isParkRowInputSizeMarker(rowInput)
+                ? 'truncated'
+                : undefined;
+    const args = streamArgs !== undefined && streamArgs !== null ? streamArgs : rowArgsGap !== undefined ? {} : rowInput;
     if (typeof args !== 'object' || args === null) {
         return { kind: 'failed', stage: 'input', gatedCallId, reason: 'gate has no tool input payload' };
     }
@@ -165,8 +196,15 @@ export async function surfaceFsApprovalAndDecide(deps, taskId, argsByCall, signa
         args,
         callKey,
         ...(signal ? { signal } : {}),
+        ...(rowArgsGap !== undefined
+            ? {
+                argsUnavailable: true,
+                wireNote: rowArgsGap === 'truncated' ? PARK_ROW_ARGS_TRUNCATED_NOTE : PARK_ROW_ARGS_ABSENT_NOTE,
+            }
+            : {}),
         ...(pending.governanceForced === true ? { governanceForced: true } : {}),
         ...(pending.requiresRealApproval === true ? { requiresRealApproval: true } : {}),
+        ...(pending.mandated === true ? { mandated: true } : {}),
         ...(pending.gateKind === 'irreversible_ask' ? { irreversibleParkGate: true } : {}),
         ...(pending.hasBidiControls === true ? { hasBidiControls: true } : {}),
         ...(ruleOffersReadOnly !== undefined ? { ruleOffersReadOnly } : {}),
@@ -184,6 +222,11 @@ export async function surfaceFsApprovalAndDecide(deps, taskId, argsByCall, signa
             ? { toolCallId: pending.toolCallId }
             : {}),
     });
+    if (rowArgsGap !== undefined && card.kind === 'allow' && card.updatedInput !== undefined) {
+        hostLog('error', `liveToolApprovalWire: approval card for ${gatedCallId ?? `task ${taskId}`} returned an edited approval, but the tool input is ${rowArgsGap === 'truncated' ? 'a size marker on the pending row' : 'missing from both the stream and the pending row'} — nothing sent (the park stays pending)`);
+        surfaceEditRefusedOnBlindAsk();
+        return { kind: 'failed', stage: 'card', gatedCallId, reason: PARK_EDIT_REFUSED_REASON, editRefused: true };
+    }
     const decideSpan = bridge.openDecideOperation();
     const decideOpts = { ...(signal ? { signal } : {}), operation: decideSpan };
     try {
@@ -733,10 +776,14 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
             ? frame.args
             : undefined;
     let wireNote;
+    let argsFallback = false;
     if (typeof args !== 'object' || args === null) {
+        argsFallback = true;
+        const p = pathFromGateMessage(frame.message);
+        args = p !== undefined ? { file_path: p } : {};
         if (frame.argsOmitted === true) {
-            wireNote = 'tool arguments exceeded the wire cap and were omitted — the diff below is reconstructed from the gate message, not the full payload';
-            hostLog('debug', `liveToolApprovalWire: frame ${approvalId} args omitted (>16KiB wire cap) — card falls back to message-derived path`);
+            wireNote = p !== undefined ? ARGS_OMITTED_PATH_RECOVERED_NOTE : ARGS_OMITTED_NOTHING_RECOVERED_NOTE;
+            hostLog('debug', `liveToolApprovalWire: frame ${approvalId} args omitted (>16KiB wire cap) — card falls back to ${p !== undefined ? 'the message-derived path' : 'an empty input (no path could be derived from the message)'}`);
         }
         if (lane?.argsUnavailable === true) {
             wireNote =
@@ -744,9 +791,8 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
                     'so you are deciding without seeing them; deny it if you are not sure what it will do. ' +
                     'Edits are not accepted on this card: there is no original input to edit';
         }
-        const p = pathFromGateMessage(frame.message);
-        args = p !== undefined ? { file_path: p } : {};
     }
+    const argsNotRealInput = argsFallback || lane?.argsUnavailable === true;
     const ruleOffers = readRuleOfferSupply(frame.ruleOffers, frame.ruleSuggestions);
     const denialLimitFallback = readDenialLimitFallback(frame.denialLimitFallback);
     const card = await surfaceApprovalCard({
@@ -759,7 +805,7 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
         ...(signal ? { signal } : {}),
         ...(isFromSubagent(frame) ? { workerBadge: subagentBadgeFor(frame) } : {}),
         ...(wireNote !== undefined ? { wireNote } : {}),
-        ...(lane?.argsUnavailable === true ? { argsUnavailable: true } : {}),
+        ...(argsNotRealInput ? { argsUnavailable: true } : {}),
         ...(frame.governanceForced === true ? { governanceForced: true } : {}),
         ...(lane?.windowIsCurrent === true
             ? {
@@ -791,8 +837,8 @@ export async function surfaceToolApprovalFrameAndRespond(frame, respond, streamA
         ...((k) => (k !== undefined ? { ruleStoreUnreadable: k } : {}))(readRuleStoreUnreadable(frame.ruleStoreUnreadable)),
         ...(typeof frame.origin === 'string' && frame.origin !== '' ? { origin: frame.origin } : {}),
     });
-    if (lane?.argsUnavailable === true && card.kind === 'allow' && card.updatedInput !== undefined) {
-        hostLog('error', `liveToolApprovalWire: ${approvalId} card returned an edited approval on an args-unavailable ask — nothing sent (the ask stays pending)`);
+    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)`);
         surfaceEditRefusedOnBlindAsk();
         return { decision: 'unresolved', editRefused: true };
     }

package/dist/hooksWireCaps.js

@@ -12,6 +12,26 @@ function hooksLockedToPluginOnly(policyValue) {
         return policyValue.includes('hooks');
     return false;
 }
+let warnedNoMergedReader = new WeakSet();
+const NO_MERGED_READER_WARNING = 'client-core: the installed settings port does not implement mergedDisableAllHooks() — ' +
+    'a disableAllHooks set in user, project, local or flag settings is not applied to hooks sent to the engine ' +
+    '(only a managed-settings disableAllHooks is). Implement SettingsPort.mergedDisableAllHooks() to return ' +
+    'the effective merged value.';
+function nonManagedDisableAllHooks(settings) {
+    try {
+        if (typeof settings.mergedDisableAllHooks === 'function')
+            return settings.mergedDisableAllHooks() === true;
+    }
+    catch (err) {
+        hostLog('debug', `hooksWireCaps: merged disableAllHooks read threw — fail-closed (only policySettings hooks projected to the engine): ${String(err)}`);
+        return true;
+    }
+    if (!warnedNoMergedReader.has(settings)) {
+        warnedNoMergedReader.add(settings);
+        hostLog('warn', NO_MERGED_READER_WARNING);
+    }
+    return false;
+}
 function hooksOfSource(source) {
     try {
         const s = hostSettings()?.getSettingsForSource(source);
@@ -52,7 +72,12 @@ export function hooksForWire() {
     if (pluginOnlyHooks) {
         hostLog('debug', 'hooksWireCaps: strictPluginOnlyCustomization locks the hooks surface (managed) — only policySettings hooks projected to the engine');
     }
-    const managedOnly = policy?.allowManagedHooksOnly === true || pluginOnlyHooks;
+    const managedByPolicy = policy?.allowManagedHooksOnly === true || pluginOnlyHooks;
+    const disabledByNonManaged = !managedByPolicy && nonManagedDisableAllHooks(settings);
+    if (disabledByNonManaged) {
+        hostLog('debug', 'hooksWireCaps: disableAllHooks (merged, non-managed) — only policySettings hooks projected to the engine');
+    }
+    const managedOnly = managedByPolicy || disabledByNonManaged;
     const sources = managedOnly
         ? ['policySettings']
         : ['policySettings', ...EDITABLE_HOOK_SOURCES];
@@ -75,6 +100,7 @@ export function hooksForWire() {
 }
 export function __resetHooksWireCapsForTests() {
     __resetGoalStopHookForTests();
+    warnedNoMergedReader = new WeakSet();
 }
 export function fleetHookFailureNoticeCapable(baseUrl) {
     return engineCapNestedTrue(baseUrl, 'fleet', 'hookFailureNotice');

package/dist/host.d.ts

@@ -4,6 +4,7 @@ export type SettingsDocument = Record<string, unknown>;
 export interface SettingsPort {
     getSettingsForSource(source: string): SettingsDocument | null;
     shouldSkipHookDueToTrust(hook?: unknown): boolean;
+    mergedDisableAllHooks?(): boolean | undefined;
 }
 export interface FsPort {
     getScratchpadDir(): string | undefined;

package/dist/liveInitToolFace.d.ts

@@ -15,7 +15,9 @@ export declare function probeScenarioTools(baseUrl: string, scenario: string, op
     tools: string[];
     toolset?: string;
 } | null>;
-export declare function resolveLiveInitToolFace(argv: readonly string[], env: EnvLike, opts?: {
+export interface LiveInitToolFaceOptions {
     fetchImpl?: typeof fetch;
     timeoutMs?: number;
-}): Promise<LiveInitToolFace | null>;
+    webSearchStamped?: boolean;
+}
+export declare function resolveLiveInitToolFace(argv: readonly string[], env: EnvLike, opts?: LiveInitToolFaceOptions): Promise<LiveInitToolFace | null>;

package/dist/liveInitToolFace.js

@@ -2,7 +2,7 @@ import { makeEngineWireClient, resolveWireAuth } from './engineWireSdk.js';
 import { hostLog } from './host.js';
 import { scenarioForPrint } from './scenarioWire.js';
 import { resolveHeadlessInteractiveTools } from './interactiveToolsWire.js';
-import { webSearchFromEnv } from './webSearchWireCaps.js';
+import { webSearchVerdictFromEnv } from './webSearchWireCaps.js';
 export const ENGINE_HANDS_BAND = [
     'Bash',
     'Read',
@@ -105,7 +105,7 @@ export async function resolveLiveInitToolFace(argv, env, opts) {
         }
         let webSearch = false;
         try {
-            webSearch = webSearchFromEnv(env) !== undefined;
+            webSearch = typeof opts?.webSearchStamped === 'boolean' ? opts.webSearchStamped : webSearchVerdictFromEnv(env).kind === 'honored';
         }
         catch {
         }

package/dist/model/catalogLoader.d.ts

@@ -1,5 +1,5 @@
 import { type EnvLike } from '../hostEnv.js';
-import { type ModelCatalogResult, type OnlineCatalogDoc } from './catalog.js';
+import { type ModelCatalogResult } from './catalog.js';
 import type { ProviderPreset } from './providerPresets.js';
 export declare const DEFAULT_CATALOG_SOURCES: readonly string[];
 export declare const CATALOG_DEFAULT_HOSTS: readonly string[];
@@ -12,11 +12,6 @@ export interface CatalogSourceAttempt {
     shaChecked?: boolean;
     detail?: string;
 }
-export interface CatalogCacheEnvelope {
-    fetchedAt?: number;
-    sourceUrl: string;
-    catalog: OnlineCatalogDoc;
-}
 export interface CatalogCachePort {
     read(path: string): string | null | Promise<string | null>;
     writeAtomic(path: string, text: string): void | Promise<void>;

package/dist/panelRunningHistory.d.ts

@@ -1,6 +1,6 @@
 export declare function notePanelRowRunning(taskId: string): void;
 export declare function retirePanelRowRunning(taskId: string): void;
-export interface PanelRowEndedIdentity {
+interface PanelRowEndedIdentity {
     cycleSeq?: number;
     startedAt?: number;
 }
@@ -11,7 +11,7 @@ export declare function holdNewbornTerminalRow(taskId: string, ev: object): void
 export declare function peekHeldNewbornTerminalRow<T extends object>(taskId: string): T | undefined;
 export declare function takeHeldNewbornTerminalRow<T extends object>(taskId: string): T | undefined;
 export declare function dropHeldNewbornTerminalRow(taskId: string): void;
-export interface HeldNewbornTerminalRef {
+interface HeldNewbornTerminalRef {
     readonly taskId: string;
     readonly transcriptId?: string;
     readonly parentToolCallId?: string;
@@ -19,3 +19,4 @@ export interface HeldNewbornTerminalRef {
 export declare function heldNewbornTerminalRefs(): HeldNewbornTerminalRef[];
 export declare function __resetPanelRunningHistoryForTests(): void;
 export declare function __panelRunningHistorySize(): number;
+export {};

package/dist/peerFrames.d.ts

@@ -1,7 +1,6 @@
 export declare const AGENT_MESSAGE_TAG = "agent-message";
 export declare const CROSS_SESSION_MESSAGE_TAG = "cross-session-message";
 export declare const PEER_FRAME_LANES: readonly ["agent_message", "cross_session_message", "cross_session_notice"];
-export type PeerFrameLane = (typeof PEER_FRAME_LANES)[number];
 export declare const CROSS_SESSION_NOTICE_KINDS: readonly ["delivery_notice", "idle_notice"];
 export type CrossSessionNoticeKind = (typeof CROSS_SESSION_NOTICE_KINDS)[number];
 export declare const PEER_MODE_CLASSES: readonly ["bypass", "prompting"];

package/dist/printInitToolFace.js

@@ -19,7 +19,7 @@ export function printInitRosterSignal(message) {
         if (type === 'result')
             return { kind: 'no-roster', reason: 'run-ended' };
         if (type === 'assistant') {
-            return rec.isApiErrorMessage === true ? { kind: 'no-roster', reason: 'run-ended' } : { kind: 'no-roster', reason: 'model-activity-first' };
+            return rec._sema_api_error_message === true ? { kind: 'no-roster', reason: 'run-ended' } : { kind: 'no-roster', reason: 'model-activity-first' };
         }
         if (type === 'stream_event' || type === 'retry_status')
             return { kind: 'no-roster', reason: 'model-activity-first' };

package/dist/request/printNotification.js

@@ -10,19 +10,19 @@ export const PRINT_NOTIFICATION_FIELD_MATRIX = [
     { field: 'tool_use_id', from: 'toolUseId', cc: true, why: 'CC 逐字 snake 名(wire 是 camel);把通知钉回发起它的那次工具调用' },
     { field: 'output_file', from: 'output_file', cc: true, why: 'CC 逐字;后台输出落盘路径' },
     { field: 'usage', from: 'usage', cc: true, why: 'CC 逐字 optional;计量面(交互面 XML 反而不读它 —— 那是渲染面口径)' },
-    { field: 'stoppedBy', from: 'stoppedBy', cc: false, why: '🔴 残局归因核心位:谁停的(用户/上限/引擎)。修前 `-p` 出口零携带' },
-    { field: 'resumable', from: 'resumable', cc: false, why: '🔴 残局归因:还能不能 resume —— 自动化要靠它决定重试还是放弃' },
-    { field: 'partial', from: 'partial', cc: false, why: 'server 1.258:被终止子代的残果(消费方须渲成不完整,不得当完整结果)' },
-    { field: 'exitCode', from: 'exitCode', cc: false, why: '后台 bash 退出码(137=OOM 这类归因只在这一位上)' },
-    { field: 'diagnostics', from: 'diagnostics', cc: false, why: '引擎侧诊断串(UNTRUSTED,service 已 redact)' },
-    { field: 'result', from: 'result', cc: false, why: '完成结果正文(#49 C1:帧带 result 必入 XML,print 出口同理不得独漏)' },
-    { field: 'lines', from: 'lines', cc: false, why: '尾部输出行(UNTRUSTED);交互面折进 <output-lines>' },
-    { field: 'recentSteps', from: 'recentSteps', cc: false, why: '结构化残局步骤 {tool,target,outcome}[] —— **原样透传**,不降级成交互面那份显示串(SDK 消费方要结构)' },
-    { field: 'editedFiles', from: 'editedFiles', cc: false, why: '结构化改档清单 {path,edits}[];同上原样透传' },
-    { field: 'task_type', from: 'task_type', cc: false, why: 'lane 位(external/background_agent/…)—— 去重键的分域依据,消费方要能自己算同一把键' },
-    { field: 'source', from: 'source', cc: false, why: 'external lane 的来源标识(交互面渲成开标签 from= 属性)' },
-    { field: 'seq', from: 'seq', cc: false, why: '停机周期/批次计数([508]②)—— 与 task_id+status 一起构成去重键' },
-    { field: 'injected', from: 'injected', cc: false, why: '[1818]§四:本帧**不**证明 XML 已进模型上下文;消费方须按此位判,不得按帧到达判' },
+    { field: '_sema_stopped_by', from: 'stoppedBy', cc: false, why: '🔴 残局归因核心位:谁停的(用户/上限/引擎)。修前 `-p` 出口零携带' },
+    { field: '_sema_resumable', from: 'resumable', cc: false, why: '🔴 残局归因:还能不能 resume —— 自动化要靠它决定重试还是放弃' },
+    { field: '_sema_partial', from: 'partial', cc: false, why: 'server 1.258:被终止子代的残果(消费方须渲成不完整,不得当完整结果)' },
+    { field: '_sema_exit_code', from: 'exitCode', cc: false, why: '后台 bash 退出码(137=OOM 这类归因只在这一位上)' },
+    { field: '_sema_diagnostics', from: 'diagnostics', cc: false, why: '引擎侧诊断串(UNTRUSTED,service 已 redact)' },
+    { field: '_sema_result', from: 'result', cc: false, why: '完成结果正文(#49 C1:帧带 result 必入 XML,print 出口同理不得独漏)' },
+    { field: '_sema_lines', from: 'lines', cc: false, why: '尾部输出行(UNTRUSTED);交互面折进 <output-lines>' },
+    { field: '_sema_recent_steps', from: 'recentSteps', cc: false, why: '结构化残局步骤 {tool,target,outcome}[] —— **原样透传**,不降级成交互面那份显示串(SDK 消费方要结构)' },
+    { field: '_sema_edited_files', from: 'editedFiles', cc: false, why: '结构化改档清单 {path,edits}[];同上原样透传' },
+    { field: '_sema_task_type', from: 'task_type', cc: false, why: 'lane 位(external/background_agent/…)—— 去重键的分域依据,消费方要能自己算同一把键;CC 的 task_type 只在 task_started / task_progress 子型上且词表不同,故不占 CC 名' },
+    { field: '_sema_source', from: 'source', cc: false, why: 'external lane 的来源标识(交互面渲成开标签 from= 属性)' },
+    { field: '_sema_seq', from: 'seq', cc: false, why: '停机周期/批次计数([508]②)—— 与 task_id+status 一起构成去重键' },
+    { field: '_sema_injected', from: 'injected', cc: false, why: '[1818]§四:本帧**不**证明 XML 已进模型上下文;消费方须按此位判,不得按帧到达判' },
 ];
 const PRINT_FRAME_KEYS = new Set(PRINT_NOTIFICATION_FIELD_MATRIX.map(r => r.field));
 export function taskNotificationToPrintFrame(n, identity = {}) {
@@ -39,19 +39,19 @@ export function taskNotificationToPrintFrame(n, identity = {}) {
         ...(f.toolUseId !== undefined ? { tool_use_id: f.toolUseId } : {}),
         ...(f.outputFile !== undefined ? { output_file: f.outputFile } : {}),
         ...(n.usage !== undefined ? { usage: n.usage } : {}),
-        ...(f.stoppedBy !== undefined ? { stoppedBy: f.stoppedBy } : {}),
-        ...(f.resumable !== undefined ? { resumable: f.resumable } : {}),
-        ...(f.partial !== undefined ? { partial: f.partial } : {}),
-        ...(f.exitCode !== undefined ? { exitCode: f.exitCode } : {}),
-        ...(f.diagnostics !== undefined ? { diagnostics: f.diagnostics } : {}),
-        ...(f.result !== undefined ? { result: f.result } : {}),
-        ...(f.lines !== undefined ? { lines: f.lines } : {}),
-        ...(nonEmptyList(n.recentSteps) ? { recentSteps: n.recentSteps } : {}),
-        ...(nonEmptyList(n.editedFiles) ? { editedFiles: n.editedFiles } : {}),
-        ...(f.taskType !== undefined ? { task_type: f.taskType } : {}),
-        ...(f.externalSource !== undefined ? { source: f.externalSource } : {}),
-        ...(typeof n.seq === 'number' || typeof n.seq === 'string' ? { seq: n.seq } : {}),
-        ...(typeof n.injected === 'boolean' ? { injected: n.injected } : {}),
+        ...(f.stoppedBy !== undefined ? { _sema_stopped_by: f.stoppedBy } : {}),
+        ...(f.resumable !== undefined ? { _sema_resumable: f.resumable } : {}),
+        ...(f.partial !== undefined ? { _sema_partial: f.partial } : {}),
+        ...(f.exitCode !== undefined ? { _sema_exit_code: f.exitCode } : {}),
+        ...(f.diagnostics !== undefined ? { _sema_diagnostics: f.diagnostics } : {}),
+        ...(f.result !== undefined ? { _sema_result: f.result } : {}),
+        ...(f.lines !== undefined ? { _sema_lines: f.lines } : {}),
+        ...(nonEmptyList(n.recentSteps) ? { _sema_recent_steps: n.recentSteps } : {}),
+        ...(nonEmptyList(n.editedFiles) ? { _sema_edited_files: n.editedFiles } : {}),
+        ...(f.taskType !== undefined ? { _sema_task_type: f.taskType } : {}),
+        ...(f.externalSource !== undefined ? { _sema_source: f.externalSource } : {}),
+        ...(typeof n.seq === 'number' || typeof n.seq === 'string' ? { _sema_seq: n.seq } : {}),
+        ...(typeof n.injected === 'boolean' ? { _sema_injected: n.injected } : {}),
         ...(identity.uuid !== undefined ? { uuid: identity.uuid } : {}),
         ...(identity.session_id !== undefined ? { session_id: identity.session_id } : {}),
     };

package/dist/seam.d.ts

@@ -149,7 +149,7 @@ export type ChromeEvent = {
 } | ({
     kind: 'run_cost_reconciled';
     laneProof: LaneProof;
-} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | PromptAssembledChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent;
+} & RunCostReconcile) | HumanInputChromeEvent | MessageCommittedChromeEvent | EngineNoticeChromeEvent | TextSegmentEndChromeEvent | ThinkingSegmentEndChromeEvent | ToolDisclosureChromeEvent | ToolProgressChromeEvent | ToolRosterDeltaChromeEvent | ContextUsageChromeEvent | CompactionOutcomeChromeEvent | PromptAssembledChromeEvent | MemorySavedChromeEvent | WiringManifestChromeEvent | ResultTextDivergedChromeEvent | ApprovalRequestChromeEvent | ApprovalRevokeChromeEvent;
 export interface WiringManifestChromeEvent {
     kind: 'wiring_manifest';
     laneProof: LaneProof;
@@ -204,6 +204,12 @@ export interface CompactionOutcomeChromeEvent {
     reason?: string;
     eventId?: string;
 }
+export interface MemorySavedChromeEvent {
+    kind: 'memory_saved';
+    laneProof: LaneProof;
+    id: string;
+    notes: string[];
+}
 export interface PromptAssembledChromeEvent {
     kind: 'prompt_assembled';
     laneProof: LaneProof;
@@ -330,4 +336,4 @@ export declare function deriveTranscriptId(frame: {
     id?: unknown;
     seq?: unknown;
     toolCallId?: unknown;
-}, ctx: Pick<AdapterContext, 'uuid'>): string;
+}, ctx: Pick<AdapterContext, 'uuid'>, suffix?: string): string;