@sema-agent/client-core 0.104.1 → 0.106.0

package/dist/index.js

@@ -66,6 +66,9 @@ export * from './steerPriorityCapability.js';
 export * from './permissionModesCapability.js';
 export * from './approvalDecidedByCapability.js';
 export * from './outputStyleSeatCapability.js';
+export * from './permissionModeWriteCapability.js';
+export { setRunPermissionMode, runPermissionModeSwitchLine } from './runPermissionModeSwitch.js';
+export { observedMcpTransportKinds, projectMcpTransportKindsCapability } from './mcpTransportKindsCapability.js';
 export * from './mcpProbeWire.js';
 export * from './connectorStatus.js';
 export * from './effectiveFacts.js';
@@ -88,6 +91,7 @@ export * from './classifierStatus.js';
 export * from './engineToolLabelStore.js';
 export * from './fleetTaskDesc.js';
 export { displayUntrusted, displayUntrustedMarks, displayConfiguredUrl, queryCarriesCredential, cleanUntrustedScalar } from './displayUntrusted.js';
+export { DISPLAY_DECISION_BODY } from './displayUntrusted.js';
 export { isDiagnosticValueWord } from './displayUntrusted.js';
 export * from './hostEnv.js';
 export * from './unrefTimer.js';
@@ -99,7 +103,7 @@ export * from './engineWireSdk.js';
 export * from './classifierVerdictWire.js';
 export { stripSystemReminderBlocks, unwrapSystemReminder } from './systemReminderTag.js';
 export { findSystemReminderOpenTag } from './systemReminderTag.js';
-export { ACTIVE_RUN_BUSY_ERROR_CODE, APPROVAL_EXPIRED, ASK_GONE, asModelFallbackReason, CAPABILITY_IMAGE_INDEX_REQUIRED, CAPABILITY_K8S_LANE_REQUIRED, CAPABILITY_OPERATOR_PRINCIPALS_REQUIRED, CAPABILITY_SELF_ORCHESTRATION_REQUIRED, CONFIG_AGENT_UNKNOWN_TOOL, CONFIG_DELEGATION_ENTRY_CAPS, CONFIG_IMAGE_INVALID, CONFIG_LEGACY_TOOL_NAME, CONFIG_LIMIT_INVALID, CONFIG_LIMIT_UNKNOWN_KEY, CONFIG_MCP_SERVER_NAME_COLLISION, CONFIG_MEMORY_PROJECT_KEY_SPELLING, CONFIG_MEMORY_WRITE_SCOPE_MISMATCH, CONFIG_OUTPUT_STYLE_INVALID, CONFIG_TOOL_FACE_CONTROL, CONFLICT_IDEMPOTENCY_PAYLOAD_MISMATCH, CORRUPT_SESSION_ERROR_CODE, DECIDE_CLAIM_LOST, DECIDE_GATE_MOVED, DECIDE_NOT_PARKED, DECIDE_PARK_MOVED_CODES, DECIDE_ROW_UNREVIVABLE, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_PARK_FORKED, DECIDE_WORKFLOW_PARKS_UNREADABLE, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, DELEGATION_CAP_CODES, DELEGATION_CONCURRENCY_CAP, DELEGATION_SESSION_CAP, delegationCapDispositionOf, DRAINING_ERROR_CODE, ENGINE_STOP_REASONS, engineStopReasonToCc, ENV_LIFETIME_EXPIRED, FLEET_LEASE_UNAVAILABLE, GATE_PARKED_ERROR_CODE, idempotencyPayloadMismatchContent, isConfigRefusalCode, isCorruptSessionCode, isDecideParkMovedCode, isDecideRowUnrevivableCode, isDelegationCapCode, isIdempotencyPayloadMismatchCode, isInterruptedToolEndCode, isLimitsExceededCode, isRewindFamilyCode, isRulesRefusalCode, isStatusDerivedCoarseCode, isWorkflowParkRefusalCode, LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, MCP_SERVER_REVOKED, MCP_TOOL_DECLARATION_CHANGED, MCP_TOOL_LISTING_UNREACHED, MODEL_FALLBACK_INHERIT_NO_TIER_BINDING, operatorGateRefusalContent, OUTPUT_INVALID, PARKED_RESUME_STARTUP_FAILED, PROMPT_ASSEMBLED_ROLE_REFUSED, REQUEST_AUTONOMY_LANE_REFUSED, RESUME_AT_ERROR_CODE_PREFIX, RESUME_CONTEXT_UNAVAILABLE, RESUME_ENV_FAILED, RESUME_PLACEMENT_MISMATCH, RESUME_POLICY_FOLD_CODE, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_RETRY_LATER_CODES, RESUME_TOOL_CONTRACT_MISMATCH, RESUME_TOOL_UNAVAILABLE, RESUME_USAGE_WINDOW_EXHAUSTED, REWIND_ERROR_CODE_PREFIXES, RUN_ORPHANED, RUN_STALLED, runDeathVerdictNoteOf, SCENARIO_ASSIGNMENT_UNKNOWN_ERROR_CODE, SCENARIO_NOT_ALLOWED_ERROR_CODE, STREAM_MAX_DURATION, TOOL_END_INTERRUPTED_NEVER_STARTED, TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN, USAGE_WINDOW_EXHAUSTED, USER_ATTACHMENT_INVALID_ERROR_CODE, USER_INVOKED_SKILL_UNKNOWN_ERROR_CODE, WORKFLOW_PARK_REFUSAL_CODES, } from './engineErrorCodes.js';
+export { ACTIVE_RUN_BUSY_ERROR_CODE, APPROVAL_EXPIRED, ASK_GONE, asModelFallbackReason, CAPABILITY_IMAGE_INDEX_REQUIRED, CAPABILITY_K8S_LANE_REQUIRED, CAPABILITY_OPERATOR_PRINCIPALS_REQUIRED, CAPABILITY_SELF_ORCHESTRATION_REQUIRED, CONFIG_AGENT_UNKNOWN_TOOL, CONFIG_DELEGATION_ENTRY_CAPS, CONFIG_IMAGE_INVALID, CONFIG_LEGACY_TOOL_NAME, CONFIG_LIMIT_INVALID, CONFIG_LIMIT_UNKNOWN_KEY, CONFIG_MCP_SERVER_NAME_COLLISION, CONFIG_MEMORY_PROJECT_KEY_SPELLING, CONFIG_MEMORY_WRITE_SCOPE_MISMATCH, CONFIG_OUTPUT_STYLE_INVALID, CONFIG_TOOL_FACE_CONTROL, CONFLICT_IDEMPOTENCY_PAYLOAD_MISMATCH, CORRUPT_SESSION_ERROR_CODE, DECIDE_CLAIM_LOST, DECIDE_GATE_MOVED, DECIDE_NOT_PARKED, DECIDE_PARK_MOVED_CODES, DECIDE_ROW_UNREVIVABLE, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_PARK_FORKED, DECIDE_WORKFLOW_PARKS_UNREADABLE, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, DELEGATION_CAP_CODES, DELEGATION_CONCURRENCY_CAP, DELEGATION_SESSION_CAP, delegationCapDispositionOf, DRAINING_ERROR_CODE, ENGINE_STOP_REASONS, engineStopReasonToCc, ENV_LIFETIME_EXPIRED, FLEET_LEASE_UNAVAILABLE, GATE_PARKED_ERROR_CODE, idempotencyPayloadMismatchContent, isConfigRefusalCode, isCorruptSessionCode, isDecideParkMovedCode, isDecideRowUnrevivableCode, isDelegationCapCode, isIdempotencyPayloadMismatchCode, isInterruptedToolEndCode, isLimitsExceededCode, isRewindFamilyCode, isRulesRefusalCode, isStatusDerivedCoarseCode, isWorkflowParkRefusalCode, LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, MCP_SERVER_REVOKED, MCP_TOOL_DECLARATION_CHANGED, MCP_TOOL_LISTING_UNREACHED, MODEL_FALLBACK_INHERIT_NO_TIER_BINDING, operatorGateRefusalContent, OUTPUT_INVALID, PARKED_RESUME_STARTUP_FAILED, PROMPT_ASSEMBLED_ROLE_REFUSED, REQUEST_AUTONOMY_LANE_REFUSED, RESUME_AT_ERROR_CODE_PREFIX, RESUME_CONTEXT_UNAVAILABLE, RESUME_ENV_FAILED, RESUME_PLACEMENT_MISMATCH, RESUME_POLICY_FOLD_CODE, RESUME_PREFLIGHT_REJECTED, RESUME_REOPEN_CODES, RESUME_RETRY_LATER_CODES, RESUME_TOOL_CONTRACT_MISMATCH, RESUME_TOOL_UNAVAILABLE, RESUME_USAGE_WINDOW_EXHAUSTED, REWIND_ERROR_CODE_PREFIXES, RUN_ORPHANED, RUN_STALLED, runDeathVerdictNoteOf, SCENARIO_ASSIGNMENT_UNKNOWN_ERROR_CODE, SCENARIO_NOT_ALLOWED_ERROR_CODE, STREAM_MAX_DURATION, TOOL_END_INTERRUPTED_NEVER_STARTED, TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN, USAGE_WINDOW_EXHAUSTED, USER_ATTACHMENT_INVALID_ERROR_CODE, USER_INVOKED_SKILL_UNKNOWN_ERROR_CODE, WORKFLOW_PARK_REFUSAL_CODES, ATTACHMENT_BOUND_ELSEWHERE, ATTACHMENT_BUNDLE_INVALID, ATTACHMENT_BUNDLE_LANE_NOT_ISOLATED, ATTACHMENT_BUNDLE_SEED_FIXED, CONFLICT_SESSION_MEMORY_UNOBSERVED, CONFLICT_SESSION_ARCHIVE_STAMPED, ENV_HOME_UNCONFIRMED, } from './engineErrorCodes.js';
 export { prepareRefusalCodeOf, prepareRefusalNoteOf } from './prepareRefusal.js';
 export * from './agentsWireCaps.js';
 export { engineToolDirectoryOf } from './engineToolDirectory.js';
@@ -152,6 +156,7 @@ export * from './adapter/activeRunSelfHeal.js';
 export * from './request/taskRequest.js';
 export { disableSkillsDeclaration, disableSkillsDeclarationSettled } from './disableSkillsWire.js';
 export { approvalReachDeclaration, approvalReachDeclarationSettled } from './approvalReachWire.js';
+export { approvalSeatOf, APPROVAL_SEAT_STATES, APPROVAL_SEAT_BASES } from './approvalSeat.js';
 export { PERMISSIONS_KEPT_REASONS, WIRE_RULE_TRUST_ORDER, permissionsAllowKeptNotice, permissionsDeclaration, permissionsDeclarationReport } from './permissionsDeclaration.js';
 export { ASSEMBLY_REFUSAL_CAUSES, assemblyRefusalOf } from './wireFailureShape.js';
 export * from './clientSlice.js';
@@ -191,7 +196,8 @@ export { guardedRead, readOwnDataFiniteNumber, readOwnDataNonEmptyString } from
 export { contextUsageReadingOf } from './ownKey.js';
 export { TURN_FAILURE_CATEGORIES, turnFailurePresentation } from './turnFailurePresentation.js';
 export { readSeatTurnFailure, seatTurnFailureOf } from './turnFailurePresentation.js';
-export { REATTACH_BUDGET_FRESH, REATTACH_MAX_TRIES, runReattachPolicy, } from './runReattachPolicy.js';
+export { REATTACH_BUDGET_FRESH, REATTACH_BUDGET_NONE, REATTACH_MAX_TRIES, STREAM_CAP_CREDIBLE_AFTER_MS, runReattachPolicy, } from './runReattachPolicy.js';
+export { runNotFollowedNotice, runNotFollowedOf } from './runFollow.js';
 export * from './corruptSession.js';
 export * from './corruptSessionCopy.js';
 export { SEMA_TOOL_HISTORY_ACCEPTED_KEY, classifyToolHistoryMismatch, readToolHistoryAcceptedKey, readToolHistoryMismatchKey, resolveToolHistoryRewindTarget } from './toolHistoryMismatch.js';
@@ -218,6 +224,7 @@ export { POISON_FRAME_RAW_MAX, REATTACH_BACKOFF_CAP_MS, REATTACH_BACKOFF_START_M
 export * from './inheritEnvWire.js';
 export * from './inheritEnvCapability.js';
 export { SUPPORT_FLOOR, supportFloorOf, engineVersionTier, engineSupportFloorEffective, coreVersionTier, compareReleaseVersions } from './supportFloor.js';
+export { SERVER_SUPPORT_RANGE_REASONS, serverSupportRangeVerdict, serverSupportRangeSentence } from './serverSupportRange.js';
 export * from './decideReceipt.js';
 export * from './sessionMap.js';
 export * from './detachWire.js';
@@ -254,6 +261,9 @@ export * from './coreValuePorts.js';
 export { ruleToolNameVerdictOf } from './protocolSegment.js';
 export * from './hitl/askGateWire.js';
 export * from './hitl/planReviewWire.js';
+export { planReviewBodyOf } from './planReviewCardFacts.js';
+export { planReviewCardNote } from './hitl/planReviewCard.js';
+export { readRunLedgerSnapshot } from './runLedgerSnapshot.js';
 export { decisionInFlightOf, decisionReadMark } from './hitl/decisionLedger.js';
 export { ASK_PARK_AUTO_REOPEN_BLOCKS, askParkAutoReopenBlockedContent, askParkAutoReopenBlockOf, askParkRefusalBlockOf, claimAskParkAutoReopenBlockNotice, clearAskParkAutoReopenBlocks, } from './hitl/askParkAutoReopenBlock.js';
 export { HITL_DECISION_FAMILIES, HITL_DECISION_NOT_APPLIED_CAUSES, HITL_DECISION_NOT_SENT_CAUSES, HITL_DECISION_UNCONFIRMED_CAUSES, sendHitlDecision, hitlDecisionOutcomeContent, } from './hitl/decisionSend.js';
@@ -300,6 +310,9 @@ export * from './compensations.js';
 export * from './request/printNotification.js';
 export * from './seatContract.js';
 export { sessionRowTagOf, sessionRowPatchRefusalOf } from './sessionRowTag.js';
+export { sessionRowUnreadableOf } from './sessionRowTag.js';
+export { projectSeedGateContent, projectSeedGateOf, projectSeedRefusalContent, projectSeedRefusalOf } from './projectSeed.js';
+export { sessionMemorySyncNotice, sessionMemorySyncStateOf } from './sessionMemorySync.js';
 export { mcpToolTogglesToExcludeTools } from './mcpToolToggles.js';
 export { readThinkingLatch, writeThinkingLatch, thinkingLatchView, thinkingLatchSentence, thinkingLatchRowWordOf, readSeatThinkingLatch } from './thinkingLatch.js';
 export { devicesFaceOf, devicesWritesAllowed, devicesFaceDetail } from './devicesFace.js';
@@ -308,6 +321,8 @@ export { KEY_SLOT_PREFIX, keyEnvNameForEntry, onboardBaseUrlProblem, onboardRefu
 export * from './agentSession/contract.js';
 export * from './agentSession/backgroundView.js';
 export { readAssistantInbox } from './assistantInbox.js';
+export { checkpointRowVerdictOf } from './checkpointRowVerdict.js';
+export { checkpointRequirementsDamagedOf } from './checkpointRowVerdict.js';
 export { READ_CREDENTIAL_NOT_ACCEPTED_NOTICE, isReadCredentialRefusal } from './readCredentialRefusal.js';
 export { readEngineAgentRegistry, isEngineAgentRegistryListingSuperseded } from './agentSession/engineAgentRegistryRead.js';
 export { stopEngineSessionBackground, engineSessionBackgroundReceiptReadingOf, ENGINE_SESSION_BACKGROUND_RECEIPT_STATES, } from './agentSession/engineSessionBackgroundStop.js';
@@ -342,3 +357,5 @@ export { PROJECT_MEMORY_WORDS, projectMemoryOf, observedProjectMemoryCapability,
 export { sessionRulesChildrenReadLiveOf } from './sessionRulesChildrenReadLive.js';
 export { scenarioSkillsOf, observedScenarioSkillsCapability } from './scenarioSkills.js';
 export { observedApprovalFrameFamilies, approvalFrameFamiliesDeclaration } from './approvalFrameFamilies.js';
+export { sessionEngineBindingFor, commitSessionEngine, readSessionEngine, sessionDispatchTarget } from './sessionEngine.js';
+export { foldSessionPlacement } from './deviceRebind.js';

package/dist/liveInitToolFace.js

@@ -40,7 +40,6 @@ export const ENGINE_RUNNER_FACE = [
     'SendMessage',
     'ListAgents',
     'Skill',
-    'TaskOutput',
     'TaskStop',
     'ToolSearch',
     'Workflow',

package/dist/liveModelCatalog.d.ts

@@ -22,6 +22,7 @@ export interface LiveModelCatalog {
     };
     droppedEntries?: readonly LiveModelDroppedEntry[];
     candidateRejected?: unknown;
+    modelPlane?: {} | null;
 }
 export declare function setLiveModelCatalog(next: LiveModelCatalog | null): void;
 export declare function setLiveModelCatalogRefresher(fn: (() => Promise<LiveModelCatalog | null>) | null): void;
@@ -103,6 +104,20 @@ export type ModelCandidateRejectedReading = {
     readonly kind: 'unreadable';
 };
 export declare function modelCandidateRejectedOf(catalog?: LiveModelCatalog | null): ModelCandidateRejectedReading;
+export declare const MODEL_PLANE_SERVED_TABLES: readonly ["env", "catalog"];
+export type ModelPlaneServedTable = (typeof MODEL_PLANE_SERVED_TABLES)[number];
+export declare const MODEL_PLANE_CATALOG_STANCES: readonly ["absent", "adopted", "refused"];
+export type ModelPlaneCatalogStance = (typeof MODEL_PLANE_CATALOG_STANCES)[number];
+export type ModelPlaneReading = {
+    readonly kind: 'not_reported';
+} | {
+    readonly kind: 'read';
+    readonly servedTable?: ModelPlaneServedTable;
+    readonly catalog?: ModelPlaneCatalogStance;
+} | {
+    readonly kind: 'unreadable';
+};
+export declare function modelPlaneOf(catalog?: LiveModelCatalog | null): ModelPlaneReading;
 export declare function modelCandidateRejectedContent(reading: ModelCandidateRejectedReading, lang?: UiLanguage): string | undefined;
 export interface RoutePairingVerdict {
     verdict: 'ok' | 'broken' | 'unknown';

package/dist/liveModelCatalog.js

@@ -383,6 +383,43 @@ export function modelCandidateRejectedOf(catalog = getLiveModelCatalog()) {
         return unreadable;
     }
 }
+export const MODEL_PLANE_SERVED_TABLES = Object.freeze(['env', 'catalog']);
+export const MODEL_PLANE_CATALOG_STANCES = Object.freeze(['absent', 'adopted', 'refused']);
+const inWords = (words, v) => typeof v === 'string' && words.includes(v);
+export function modelPlaneOf(catalog = getLiveModelCatalog()) {
+    const unreadable = Object.freeze({ kind: 'unreadable' });
+    try {
+        if (catalog === null || typeof catalog !== 'object' || Array.isArray(catalog))
+            return Object.freeze({ kind: 'not_reported' });
+        if (!Object.hasOwn(catalog, 'modelPlane'))
+            return Object.freeze({ kind: 'not_reported' });
+        const d = Object.getOwnPropertyDescriptor(catalog, 'modelPlane');
+        if (d === undefined || !(Object.hasOwn(d, 'value')))
+            return unreadable;
+        const v = d.value;
+        if (v === undefined)
+            return Object.freeze({ kind: 'not_reported' });
+        if (v === null || typeof v !== 'object' || Array.isArray(v))
+            return unreadable;
+        const proto = Object.getPrototypeOf(v);
+        if (proto !== Object.prototype && proto !== null)
+            return unreadable;
+        const dServed = Object.getOwnPropertyDescriptor(v, 'servedTable');
+        const dStance = Object.getOwnPropertyDescriptor(v, 'catalog');
+        if ((dServed !== undefined && !Object.hasOwn(dServed, 'value')) || (dStance !== undefined && !Object.hasOwn(dStance, 'value')))
+            return unreadable;
+        const servedTable = dServed?.value;
+        const stance = dStance?.value;
+        return Object.freeze({
+            kind: 'read',
+            ...(inWords(MODEL_PLANE_SERVED_TABLES, servedTable) ? { servedTable } : {}),
+            ...(inWords(MODEL_PLANE_CATALOG_STANCES, stance) ? { catalog: stance } : {}),
+        });
+    }
+    catch {
+        return unreadable;
+    }
+}
 const CONFIG_DOMAIN_WORD = /^[a-z][a-z0-9_.-]{0,63}$/;
 export function modelCandidateRejectedContent(reading, lang) {
     try {
@@ -429,6 +466,7 @@ export function readLiveModelCatalog(body) {
         const defaultModelKey = envelopeKey(body, 'defaultModel');
         const droppedKey = envelopeKey(body, 'droppedEntries');
         const candidateKey = envelopeKey(body, 'candidateRejected');
+        const planeKey = envelopeKey(body, 'modelPlane');
         const raw = modelsKey.present ? modelsKey.value : undefined;
         if (!Array.isArray(raw))
             return unreadableCatalog('models_not_array');
@@ -464,6 +502,8 @@ export function readLiveModelCatalog(body) {
         }
         if (candidateKey.present && candidateKey.value !== undefined)
             out.candidateRejected = frozenJsonCopyOf(candidateKey.value) ?? null;
+        if (planeKey.present && planeKey.value !== undefined)
+            out.modelPlane = frozenJsonCopyOf(planeKey.value) ?? null;
         return Object.freeze({ kind: 'read', catalog: Object.freeze(out), unreadableRows, ...(defaultModelMalformed ? { defaultModelMalformed: true } : {}) });
     }
     catch {

package/dist/mcpTransportKindsCapability.d.ts

@@ -0,0 +1,18 @@
+import type { McpServerSpec } from '@sema-agent/sdk';
+export type McpRequestTransportKind = McpServerSpec['transport']['kind'];
+export declare const MCP_TRANSPORT_KINDS_WHEN_NOT_STATED: readonly ["stdio", "http"];
+export type McpTransportKindsReading = {
+    readonly kind: 'stated';
+    readonly kinds: readonly McpRequestTransportKind[];
+    readonly unrecognized: readonly string[];
+} | {
+    readonly kind: 'not_stated';
+    readonly kinds: readonly McpRequestTransportKind[];
+} | {
+    readonly kind: 'unreadable';
+} | {
+    readonly kind: 'unobserved';
+};
+export declare function projectMcpTransportKindsCapability(caps: unknown): McpTransportKindsReading | undefined;
+export declare function observedMcpTransportKinds(baseUrl?: string | undefined): McpTransportKindsReading;
+export declare function mcpTransportNotAdvertised(reading: McpTransportKindsReading | undefined, transportKind: string): readonly McpRequestTransportKind[] | undefined;

package/dist/mcpTransportKindsCapability.js

@@ -0,0 +1,75 @@
+import { engineWireTargetBaseUrl } from './engineWireTarget.js';
+import { createEngineCapReader } from './engineCapReader.js';
+import { appendOwnElement, ownDataField } from './ownKey.js';
+export const MCP_TRANSPORT_KINDS_WHEN_NOT_STATED = Object.freeze(['stdio', 'http']);
+const _kindsEqRequestFace = true;
+void _kindsEqRequestFace;
+const KNOWN = new Set(MCP_TRANSPORT_KINDS_WHEN_NOT_STATED);
+export function projectMcpTransportKindsCapability(caps) {
+    try {
+        if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
+            return undefined;
+        const v = ownDataField(caps, 'mcpTransportKinds');
+        if (v === undefined)
+            return { kind: 'not_stated', kinds: MCP_TRANSPORT_KINDS_WHEN_NOT_STATED };
+        if (!Array.isArray(v))
+            return undefined;
+        const len = ownDataField(v, 'length');
+        if (typeof len !== 'number' || !Number.isSafeInteger(len) || len < 0 || len > 1000)
+            return undefined;
+        const kinds = [];
+        const unrecognized = [];
+        for (let i = 0; i < len; i++) {
+            if (!Object.hasOwn(v, i))
+                return undefined;
+            const w = ownDataField(v, String(i));
+            if (typeof w !== 'string')
+                return undefined;
+            if (KNOWN.has(w)) {
+                if (!kinds.includes(w))
+                    appendOwnElement(kinds, w);
+            }
+            else if (!unrecognized.includes(w))
+                appendOwnElement(unrecognized, w);
+        }
+        return { kind: 'stated', kinds, unrecognized };
+    }
+    catch {
+        return undefined;
+    }
+}
+const reader = createEngineCapReader({
+    name: 'mcpTransportKinds',
+    project: projectMcpTransportKindsCapability,
+});
+export function observedMcpTransportKinds(baseUrl = engineWireTargetBaseUrl()) {
+    return reader.observed(baseUrl);
+}
+export function mcpTransportNotAdvertised(reading, transportKind) {
+    try {
+        if (reading === null || reading === undefined || typeof reading !== 'object' || Array.isArray(reading))
+            return undefined;
+        if (ownDataField(reading, 'kind') !== 'stated')
+            return undefined;
+        const kinds = ownDataField(reading, 'kinds');
+        if (!Array.isArray(kinds))
+            return undefined;
+        const len = ownDataField(kinds, 'length');
+        if (typeof len !== 'number' || !Number.isSafeInteger(len) || len < 0 || len > MCP_TRANSPORT_KINDS_WHEN_NOT_STATED.length)
+            return undefined;
+        const list = [];
+        for (let i = 0; i < len; i++) {
+            if (!Object.hasOwn(kinds, i))
+                return undefined;
+            const k = ownDataField(kinds, String(i));
+            if (typeof k !== 'string' || !KNOWN.has(k))
+                return undefined;
+            if (!list.includes(k))
+                appendOwnElement(list, k);
+        }
+        return list.includes(transportKind) ? undefined : Object.freeze([...list]);
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/mcpWireCaps.d.ts

@@ -1,5 +1,6 @@
 import type { McpServerSpec } from '@sema-agent/sdk';
 import type { McpEntryKeyIssue } from './generated/settingsSchemaTypes.js';
+import { type McpTransportKindsReading } from './mcpTransportKindsCapability.js';
 import type { UiLanguage } from './env/uiLanguage.js';
 export type { McpServerSpec };
 export interface McpConfigLike {
@@ -16,6 +17,7 @@ export interface McpConfigLike {
     toolFaces?: unknown;
     toolAxes?: unknown;
     startupTimeoutMs?: number;
+    sessionMetaKey?: string;
 }
 export type McpTransportEntryLike = Pick<McpConfigLike, 'type' | 'command' | 'args' | 'env' | 'url' | 'headers' | 'principalHeader' | 'assertionHeader'>;
 export type McpTransportVerdict = {
@@ -72,7 +74,7 @@ export type McpAllowToolsVerdict = {
     readonly problem: string;
 };
 export declare function mcpAllowToolsVerdict(read: () => {} | null | undefined, keyPrefix?: string): McpAllowToolsVerdict;
-export type McpConfigDropReason = 'name_blank' | 'name_edge_whitespace' | 'name_collides_after_trim' | 'name_too_long' | 'name_reserved' | 'transport_invalid' | 'identity_headers_both_set' | 'tool_axes_invalid' | 'tool_faces_invalid' | 'elicitation_invalid' | 'allow_tools_invalid' | 'entry_not_object' | 'entry_unreadable';
+export type McpConfigDropReason = 'name_blank' | 'name_edge_whitespace' | 'name_collides_after_trim' | 'name_too_long' | 'name_reserved' | 'transport_invalid' | 'identity_headers_both_set' | 'tool_axes_invalid' | 'tool_faces_invalid' | 'elicitation_invalid' | 'allow_tools_invalid' | 'entry_not_object' | 'entry_unreadable' | 'transport_not_advertised';
 export type McpServerNameUnusableReason = 'name_blank' | 'name_edge_whitespace' | 'name_collides_after_trim' | 'name_too_long' | 'name_reserved';
 export type McpServerNameVerdict = {
     readonly usable: true;
@@ -100,6 +102,7 @@ export interface McpConfigProjection {
 }
 export interface ProjectMcpConfigsOptions {
     readonly sourceLabel?: (serverName: string) => string | undefined;
+    readonly transportKinds?: McpTransportKindsReading;
     readonly lang?: UiLanguage;
 }
 export declare function projectMcpConfigs(servers: Record<string, McpConfigLike> | undefined, opts?: ProjectMcpConfigsOptions): McpConfigProjection;

package/dist/mcpWireCaps.js

@@ -4,14 +4,16 @@ import { appendOwnElement, guardedRead } from './ownKey.js';
 import { readMcpToolAxes, readToolFaces } from './coreValuePorts.js';
 import { capForDisplay } from './fleetTaskDesc.js';
 import { msg, renderMessage } from './i18n/translate.js';
+import { mcpTransportNotAdvertised } from './mcpTransportKindsCapability.js';
 const _mcpServerSpecPin = true;
 void _mcpServerSpecPin;
-function transparentKeys(startupTimeoutMs, axes, faces, elicitation) {
+function transparentKeys(startupTimeoutMs, axes, faces, elicitation, sessionMetaKey) {
     return {
         ...(faces !== undefined ? { toolFaces: faces } : {}),
         ...(axes !== undefined ? { toolAxes: axes } : {}),
         ...(elicitation !== undefined ? { elicitation } : {}),
         ...(startupTimeoutMs !== undefined ? { startupTimeoutMs } : {}),
+        ...(sessionMetaKey !== undefined ? { sessionMetaKey } : {}),
     };
 }
 export function readMcpHttpIdentityHeaders(transport) {
@@ -36,7 +38,7 @@ function entryShapeOf(c) {
 function readEntryOwnKeys(c) {
     try {
         const allowTools = c.allowTools;
-        return { toolAxes: c.toolAxes, elicitation: c.elicitation, allowTools, startupTimeoutMs: c.startupTimeoutMs };
+        return { toolAxes: c.toolAxes, elicitation: c.elicitation, allowTools, startupTimeoutMs: c.startupTimeoutMs, sessionMetaKey: c.sessionMetaKey };
     }
     catch {
         return undefined;
@@ -153,7 +155,7 @@ function specOf(name, c, own, axes, faces, elicitation, allowTools) {
         name,
         transport: t.transport,
         ...(allowTools !== undefined ? { allowTools } : {}),
-        ...transparentKeys(own.startupTimeoutMs, axes, faces, elicitation),
+        ...transparentKeys(own.startupTimeoutMs, axes, faces, elicitation, own.sessionMetaKey),
     };
     return { kind: 'ok', spec, lost: t.lost };
 }
@@ -305,7 +307,7 @@ const DROP_LABEL_SHOWN = 140;
 const DROP_PROBLEM_SHOWN = 300;
 const DROP_BAD_NAME_SHOWN = 160;
 const DEGRADED_LOST_SHOWN = 400;
-function dropNotice(name, reason, problem, opts, path) {
+function dropNotice(name, reason, problem, opts, path, transportKind) {
     let label;
     try {
         label = opts?.sourceLabel?.(name);
@@ -332,15 +334,17 @@ function dropNotice(name, reason, problem, opts, path) {
                                 ? msg('config.mcp.identityHeadersBothSet', { name: quoted, where })
                                 : reason === 'transport_invalid'
                                     ? msg('config.mcp.transportInvalid', { name: quoted, where, path: capForDisplay(path ?? 'transport', DROP_NAME_SHOWN), problem: capForDisplay(problem ?? '', DROP_PROBLEM_SHOWN) })
-                                    : reason === 'name_blank'
-                                        ? msg('config.mcp.nameBlank', { name: badName(), where })
-                                        : reason === 'name_collides_after_trim'
-                                            ? msg('config.mcp.nameCollides', { name: badName(), where })
-                                            : reason === 'name_too_long'
-                                                ? msg('config.mcp.nameTooLong', { name: badName(), where })
-                                                : reason === 'name_reserved'
-                                                    ? msg('config.mcp.nameReserved', { name: badName(), where })
-                                                    : msg('config.mcp.nameEdgeWhitespace', { name: badName(), where });
+                                    : reason === 'transport_not_advertised'
+                                        ? msg('config.mcp.transportNotAdvertised', { name: quoted, where, kind: capForDisplay(transportKind ?? '', DROP_NAME_SHOWN), supported: problem !== undefined && problem.length > 0 ? problem : renderMessage(msg('config.mcp.transportsNone'), opts?.lang) })
+                                        : reason === 'name_blank'
+                                            ? msg('config.mcp.nameBlank', { name: badName(), where })
+                                            : reason === 'name_collides_after_trim'
+                                                ? msg('config.mcp.nameCollides', { name: badName(), where })
+                                                : reason === 'name_too_long'
+                                                    ? msg('config.mcp.nameTooLong', { name: badName(), where })
+                                                    : reason === 'name_reserved'
+                                                        ? msg('config.mcp.nameReserved', { name: badName(), where })
+                                                        : msg('config.mcp.nameEdgeWhitespace', { name: badName(), where });
     return renderMessage(ref, opts?.lang);
 }
 function degradedNotice(name, lost, opts) {
@@ -381,6 +385,13 @@ export function projectMcpConfigs(servers, opts) {
         }
         const out = slotUnreadable ? { spec: null, entryUnreadable: true } : mcpConfigEntry(name, c);
         if (out.spec !== null) {
+            const kind = out.spec.transport.kind;
+            const supported = opts?.transportKinds === undefined ? undefined : mcpTransportNotAdvertised(opts.transportKinds, kind);
+            if (supported !== undefined) {
+                const listed = supported.join(', ');
+                dropped.push({ name, reason: 'transport_not_advertised', path: 'transport.kind', problem: listed, notice: dropNotice(name, 'transport_not_advertised', listed, opts, 'transport.kind', kind) });
+                continue;
+            }
             specs.push(out.spec);
             if (out.transportLost !== undefined)
                 degraded.push({ name, lost: Object.freeze([...out.transportLost]), notice: degradedNotice(name, out.transportLost, opts) });
@@ -437,6 +448,6 @@ export function mcpAssertionHeaderNotSentNotice(specs) {
     const parts = distinct.slice(0, ASSERTION_NOTICE_NAMES_SHOWN).map((x) => `"${x}"`);
     if (distinct.length > ASSERTION_NOTICE_NAMES_SHOWN)
         parts.push(`+${distinct.length - ASSERTION_NOTICE_NAMES_SHOWN} more`);
-    return (`MCP servers that declare an assertion header (assertionHeader): ${parts.join(', ')} — server versions up to 7.139.0 accept this setting but do not send the header, ` +
+    return (`MCP servers that declare an assertion header (assertionHeader): ${parts.join(', ')} — server versions up to 7.144.0 accept this setting but do not send the header, ` +
         'and this client cannot tell whether the engine it uses sends it; a connector that requires the header will refuse requests from these servers');
 }

package/dist/modelCapabilityProbe.js

@@ -155,15 +155,48 @@ function isBusyStatus(status) {
 function looksBusyError(apiError) {
     return apiError !== undefined && /overload|rate.?limit|too many requests|too busy|server busy|capacity/i.test(apiError);
 }
-function apiErrorOf(parsed) {
-    const e = parsed?.error;
-    if (!e || typeof e !== 'object')
+function wordOf(v) {
+    if (typeof v === 'string')
+        return v.trim() === '' ? undefined : v;
+    return typeof v === 'number' && Number.isFinite(v) && v !== 0 ? String(v) : undefined;
+}
+function hasContent(v, depth = 0) {
+    if (typeof v === 'string')
+        return v.trim() !== '';
+    if (typeof v === 'number')
+        return Number.isFinite(v) && v !== 0;
+    if (v === true)
+        return true;
+    if (v === null || typeof v !== 'object')
+        return false;
+    if (depth >= 2)
+        return true;
+    return (Array.isArray(v) ? v : Object.values(v)).some((x) => hasContent(x, depth + 1));
+}
+function errorBodyOf(parsed) {
+    if (parsed === null || typeof parsed !== 'object')
         return undefined;
-    return [e.code ?? e.type, e.message].filter(Boolean).join(': ') || undefined;
+    const e = parsed.error;
+    const o = e;
+    if (o !== null && o !== undefined && typeof o === 'object' && !Array.isArray(o)) {
+        const legacy = [o.code ?? o.type, o.message].filter(Boolean).join(': ');
+        if (legacy !== '')
+            return { words: legacy, standard: true };
+    }
+    if (!hasContent(e))
+        return undefined;
+    if (typeof e !== 'object' || e === null) {
+        const words = wordOf(e);
+        return words === undefined ? { standard: false } : { words, standard: false };
+    }
+    if (Array.isArray(e))
+        return { standard: false };
+    const words = [wordOf(o?.code) ?? wordOf(o?.type) ?? wordOf(o?.status), wordOf(o?.message) ?? wordOf(o?.detail)].filter((x) => x !== undefined).join(': ');
+    return { ...(words !== '' ? { words } : {}), standard: false };
 }
-function extractApiError(body) {
+function extractErrorBody(body) {
     try {
-        return apiErrorOf(JSON.parse(body));
+        return errorBodyOf(JSON.parse(body));
     }
     catch {
         return undefined;
@@ -189,12 +222,10 @@ function shownApiError(raw, redact) {
     const shown = displayUntrusted(masked, { max: 200 });
     return shown.trim() === '' ? undefined : shown;
 }
-function looksLikeModelError(status, apiError) {
+function namesModel(status, apiError) {
     if (status !== 400 && status !== 404 && status !== 422)
         return false;
-    if (!apiError)
-        return status === 404;
-    return /model/i.test(apiError);
+    return apiError !== undefined && /model/i.test(apiError);
 }
 const MESSAGES_PATH = '/v1/messages';
 const COMPLETIONS_PATH = '/chat/completions';
@@ -204,33 +235,33 @@ function verdictRequestBody(modelId) {
     return JSON.stringify({ model: modelId ?? '', max_tokens: 1, messages: [{ role: 'user', content: 'hi' }], stream: true });
 }
 function judgeMessagesFailure(status, body, hasModelId, near, redact) {
-    if (status === 401 || status === 403)
-        return { verdict: 'auth', httpStatus: status, path: MESSAGES_PATH };
-    const apiError = extractApiError(body);
+    const eb = extractErrorBody(body);
+    const apiError = eb?.words;
+    const standard = eb?.standard === true;
     const shown = shownApiError(apiError, redact);
     const ev = { httpStatus: status, path: MESSAGES_PATH, ...(shown !== undefined ? { apiError: shown } : {}) };
+    if (status === 401 || status === 403)
+        return { verdict: 'auth', ...ev };
     if (isBusyStatus(status) || looksBusyError(apiError))
         return { verdict: 'busy', ...ev };
-    if (status === 404 && !apiError)
-        return { verdict: 'shape', httpStatus: status, path: MESSAGES_PATH };
-    if (looksLikeModelError(status, apiError)) {
-        if (!hasModelId)
-            return { verdict: 'ok', httpStatus: status, path: MESSAGES_PATH };
-        return { verdict: 'model', ...ev, ...(near !== undefined ? { nearModelId: near } : {}) };
-    }
-    if (!hasModelId && status >= 400 && status < 500 && apiError)
+    if (!hasModelId && standard && status >= 400 && status < 500)
         return { verdict: 'ok', httpStatus: status, path: MESSAGES_PATH };
+    if (hasModelId && namesModel(status, apiError))
+        return { verdict: 'model', ...ev, ...(near !== undefined ? { nearModelId: near } : {}) };
+    if (status === 404 && !standard)
+        return { verdict: 'shape', ...ev };
     return { verdict: 'other', ...ev };
 }
 function judgeCompletionsFailure(status, body, near, redact) {
-    if (status === 401 || status === 403)
-        return { verdict: 'auth', httpStatus: status, path: COMPLETIONS_PATH };
-    const apiError = extractApiError(body);
+    const eb = extractErrorBody(body);
+    const apiError = eb?.words;
     const shown = shownApiError(apiError, redact);
     const ev = { httpStatus: status, path: COMPLETIONS_PATH, ...(shown !== undefined ? { apiError: shown } : {}) };
+    if (status === 401 || status === 403)
+        return { verdict: 'auth', ...ev };
     if (isBusyStatus(status) || looksBusyError(apiError))
         return { verdict: 'busy', ...ev };
-    if (looksLikeModelError(status, apiError))
+    if (namesModel(status, apiError) || (status === 404 && eb?.standard !== true))
         return { verdict: 'model', ...ev, ...(near !== undefined ? { nearModelId: near } : {}) };
     return { verdict: 'other', ...ev };
 }
@@ -318,9 +349,9 @@ function judgeJsonBody(text, contentType, api) {
     if (obj === null || typeof obj !== 'object')
         return { kind: 'not_model', contentType };
     const o = obj;
-    const apiError = apiErrorOf(o);
-    if (apiError !== undefined || o.type === 'error')
-        return { kind: 'error', ...(apiError !== undefined ? { apiError } : {}) };
+    const eb = errorBodyOf(o);
+    if (eb !== undefined || o.type === 'error')
+        return { kind: 'error', ...(eb?.words !== undefined ? { apiError: eb.words } : {}) };
     const usage = (o.usage ?? null);
     if (api === 'anthropic-messages') {
         if (o.type !== 'message' && !Array.isArray(o.content))
@@ -365,9 +396,9 @@ function createAnswerScanner(contentType, api) {
         if (obj === null || typeof obj !== 'object')
             return;
         const o = obj;
-        const apiError = apiErrorOf(o);
-        if (ev === 'error' || o.type === 'error' || apiError !== undefined) {
-            settled = { kind: 'error', ...(apiError !== undefined ? { apiError } : {}) };
+        const eb = errorBodyOf(o);
+        if (ev === 'error' || o.type === 'error' || eb !== undefined) {
+            settled = { kind: 'error', ...(eb?.words !== undefined ? { apiError: eb.words } : {}) };
             return;
         }
         if (isTokenFrame(o, api))
@@ -667,8 +698,10 @@ async function livenessOf(input) {
         }
     }
     const gate = await getCatalogText(fetchIt, urlOf(MODELS_PATH_OPENAI), getHeaders, catalogBudget, input.signal);
-    if (gate.status === 401 || gate.status === 403)
-        return { verdict: 'auth', httpStatus: gate.status, path: '/models' };
+    if (gate.status === 401 || gate.status === 403) {
+        const shown = shownApiError(extractErrorBody(gate.text)?.words, redact);
+        return { verdict: 'auth', httpStatus: gate.status, path: '/models', ...(shown !== undefined ? { apiError: shown } : {}) };
+    }
     if (isBusyStatus(gate.status))
         return { verdict: 'busy', httpStatus: gate.status, path: '/models' };
     if (gate.status < 200 || gate.status >= 300)

package/dist/notifications.d.ts

@@ -42,6 +42,14 @@ export declare function taskNotificationDedupKey(n: {
     seq?: number | string;
     taskType?: string;
 }): string;
+export interface TaskNotificationRenderKeyInput {
+    taskId: string;
+    status: string;
+    seq?: number | string;
+    taskType?: string;
+    completionId?: string;
+}
+export declare function taskNotificationRenderKeys(n: TaskNotificationRenderKeyInput): readonly [selfKey: string, ...completionKey: string[]];
 export declare function taskNotificationDedupKeyFromWire(raw: Record<string, unknown>): string;
 export interface TranscriptNotificationSeeds {
     renderedKeys: string[];
@@ -120,6 +128,7 @@ export interface EngineWorkflowCompletion {
     runId: string;
     status: 'completed' | 'failed';
     summary: string;
+    completionId?: string;
 }
 export declare function enqueueBgChildNotification(raw: {
     taskId: string;

package/dist/notifications.js

@@ -5,7 +5,7 @@ import { panelEndFact } from './panelReduce.js';
 import { isCoreTaskNotificationTerminal, isCoreTaskNotificationTerminalNotSuccess } from './terminalStatuses.js';
 import { cycleSeqValue } from './cycleOrder.js';
 import { CORE_ENGINE_AUTHORITY_ENVELOPE_TAGS } from './generated/engineFactTables.js';
-import { guardedRead, ownSnapshot, ownSnapshotRecord, ownSnapshotTyped, readOwnDataValue } from './ownKey.js';
+import { guardedRead, ownSnapshot, ownSnapshotRecord, ownSnapshotTyped, readOwnDataValue, workflowCompletionExtrasOf } from './ownKey.js';
 function escapeXml(v) {
     return v.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
 }
@@ -244,6 +244,14 @@ export function taskNotificationDedupKey(n) {
     const lane = n.taskType === 'external' ? 'external:' : '';
     return `${lane}${n.taskId}:${n.status}${seq ? `:${seq}` : ''}`;
 }
+const COMPLETION_KEY_PREFIX = 'completion:';
+export function taskNotificationRenderKeys(n) {
+    const own = taskNotificationDedupKey(n);
+    const id = n.completionId;
+    if (n.taskType === 'external' || !isCoreTaskNotificationTerminal(n.status) || typeof id !== 'string' || id.length === 0)
+        return [own];
+    return [own, `${COMPLETION_KEY_PREFIX}${id}`];
+}
 export function taskNotificationDedupKeyFromWire(raw) {
     const n = ownSnapshotRecord(raw) ?? {};
     return taskNotificationDedupKey({
@@ -830,6 +838,7 @@ function enqueueBgChild(n, identity) {
         ...identity,
     }));
 }
+const completionIdOnly = (x) => (x.completionId !== undefined ? { completionId: x.completionId } : {});
 export function enqueueEngineWorkflowNotification(raw) {
     const c = ownSnapshotRecord(raw);
     if (c === undefined) {
@@ -843,7 +852,7 @@ export function enqueueEngineWorkflowNotification(raw) {
     }
     markRunNotified(c.runId);
     cardEnqueuedRunIds.add(c.runId);
-    port()?.enqueuePendingNotification(taskNotificationQueueCommand({ taskId: c.runId, taskType: 'workflow', status: c.status, summary: c.summary }));
+    port()?.enqueuePendingNotification(taskNotificationQueueCommand({ taskId: c.runId, taskType: 'workflow', status: c.status, summary: c.summary, ...completionIdOnly(workflowCompletionExtrasOf(c)) }));
 }
 export function _resetEngineTaskNotificationForTest() {
     notifiedRunIds.clear();