@sema-agent/client-core 0.107.0 → 0.109.0

package/dist/index.js

@@ -15,7 +15,7 @@ export { engineRefOf, sameEngineRef, TRANSCRIPT_ROW_SIDECAR_KEYS } from './engin
 export { isReplayMarked } from './replayBody.js';
 export { composeEventLeg, EVENT_LEG_KINDS, EVENT_LEG_TABLE, approvalFrameContextOf } from './eventLeg.js';
 export { frameBindingOf, inheritFrameBinding } from './frameBinding.js';
-export { __resetSubagentContentStoreConfigForTests, __resetSubagentOwnerLedgerForTests, clearSubagentContent, coerceOutput, configureSubagentContentStore, getBgParentRun, getBgParentRunOwner, getBgTerminalFacts, getSubagentContentSnapshot, isOwnEngineRun, parentToolCallIdOf, planSubagentViewSlots, publishSubagentContentEvent, pushSubagentLocalEcho, recordBgParentRun, recordOwnEngineRun, recordSubagentOwner, recordSubagentOwnerFromProgress, registerSubagentAlias, settleSubagentContent, SUBAGENT_CONTENT_STORE_DEFAULTS, subagentContentStoreConfig, subagentOwnerSessionConflicts, subscribeSubagentContent, subagentContentEventOf, } from './subagentContentStore.js';
+export { __resetSubagentContentStoreConfigForTests, __resetSubagentOwnerLedgerForTests, clearSubagentContent, coerceOutput, configureSubagentContentStore, getBgParentRun, getBgParentRunOwner, getBgTerminalFacts, getSubagentContentSnapshot, isOwnEngineRun, noteSeatSubagentAlias, parentToolCallIdOf, planSubagentViewSlots, publishSubagentContentEvent, pushSubagentLocalEcho, recordBgParentRun, recordOwnEngineRun, recordSubagentOwner, readSeatSubagentAlias, recordSubagentOwnerFromProgress, registerSubagentAlias, settleSubagentContent, SUBAGENT_CONTENT_STORE_DEFAULTS, subagentContentStoreConfig, subagentOwnerSessionConflicts, subscribeSubagentContent, subagentContentEventOf, } from './subagentContentStore.js';
 export * from './engineAgentPanelStore.js';
 export * from './engineAgentAbsence.js';
 export * from './fleetAgentPanelProjection.js';
@@ -76,6 +76,14 @@ export * from './gateOutcome.js';
 export * from './postureKnob.js';
 export * from './engineIdentity.js';
 export { readEngineHealthFacts } from './engineHealthFacts.js';
+export { localEngineAnchorOf, localEnginePlanDriftOf, judgeLocalEngine, localEngineLaneOf, localEngineVerdictSentence } from './localEngineJudge.js';
+export { countClientRegistry, fleetBackgroundLiveOf, localEngineSelfOf, localEngineRegistryStatusOf, localEngineIdle, localEngineDemandOf, localEngineExitFate, localEngineExitFateSentence, } from './localEngineOccupancy.js';
+export { LOCAL_ENGINE_SWAP_CAUSES, localEngineSwapAutoable, engineSwapCardOf, engineSwapCardText } from './localEngineSwapCard.js';
+export { LOCAL_ENGINE_SPAWN_ENV, LOCAL_ENGINE_HOST_BITS, LOCAL_ENGINE_SPAWN_SHAPE, localEngineOperatorSingleUserOf, localEngineSpawnEnv, localEngineSeedEnv, localEnginePrincipalOf, localEnginePrincipalSentence, engineBootRefusalOf, engineBootRefusalSentence, localEngineFirstShareSentence, } from './localEngineSpawn.js';
+export { LOCAL_ENGINE_STOP_LADDER, stopLadderStep } from './localEngineStopLadder.js';
+export { LOCAL_ENGINE_INITIAL_STATE, LOCAL_ENGINE_FAIL_CODES, localEngineStep, engineSwapAnswerOutcomeOf } from './localEngineStep.js';
+export { LOCAL_ENGINE_TIMING } from './localEngineTiming.js';
+export { localEngineSeatReadingOf, localEngineSeatSentence, localEngineNoticeText, localEngineFailText, engineTargetLocalOf, engineRestartOutcomeOf, } from './localEngineSeatReading.js';
 export { transportFailureScene } from './engineWireFor.js';
 export { engineUrlTransportVerdict, normalizeEngineBaseUrl } from './engineUrl.js';
 export { submitStreamWithBoundedReopen } from './submitReopen.js';
@@ -103,7 +111,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, 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 { 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, REQUEST_ENV_CREDENTIAL_REFUSED, CONFLICT_SESSION_ID_RETIRED, } from './engineErrorCodes.js';
 export { prepareRefusalCodeOf, prepareRefusalNoteOf } from './prepareRefusal.js';
 export * from './agentsWireCaps.js';
 export { engineToolDirectoryOf } from './engineToolDirectory.js';
@@ -209,6 +217,7 @@ export { encodeHumanTurn, deliveredUuidsOf, imageSentOnUnknownVision, otherBodyB
 export { batchCompatible, planQueuedDelivery, humanTurnCapsOf, humanTextForKeywordScan, selfHealSteerEligible } from './queuedDelivery.js';
 export { SUBMISSION_SURFACES, SUBMISSION_ORIGINS, SUBMISSION_TOOLS, SUBMISSION_KINDS, submissionProvenanceOf, submissionIdentityOf, requestLaneOf, submissionOriginOf, } from './request/submissionIdentity.js';
 export { taskNotificationOf, taskNotificationQueueCommand } from './notifications.js';
+export { taskNotificationAdmissionOf } from './taskNotificationAdmission.js';
 export { resultErrorCodeInTextOf } from './resultFrameKeys.js';
 export { humanTurnRefusalSentence, humanTurnDegradedSentence, printImageVisionSentence } from './humanTurnSentences.js';
 export { observedUserAttachmentSeat, projectUserAttachmentSeatCapability, userAttachmentSeatAdmits } from './userAttachmentSeat.js';
@@ -252,9 +261,10 @@ export { ENGINE_ABORT_TOOL_RESULT } from './hitl/frameRouter.js';
 export { toolEndOutputText } from './toolResultContent.js';
 export { toolOutputMediaAbsenceOf, toolOutputMediaAbsenceSentence } from './toolResultContent.js';
 export { _resetHitlHostSurfaceForTest, APPROVAL_PARKING_WARN_TEXT, approvalParkingNoticeText, CANCEL_DENY_BUDGET_MS, CANCEL_DENY_WARN_TEXT, EDIT_NOT_FORWARDED_WARN_TEXT, EDIT_REFUSED_ON_BLIND_ASK_WARN_TEXT, hitlHostSurfaceFor, hitlHostSurfaceMisses, hitlHostSurfaceMissesFor, installHitlHostSurface, installHitlHostSurfaceFor, observeCancelByDeny, REMEMBER_NOT_APPLIED_WARN_TEXT, REPLAYED_APPROVAL_LIST_UNREADABLE_WARN_TEXT, RULE_NOT_SENT_REJECTED_WARN_TEXT, RULE_NOT_SENT_WARN_TEXT, surfaceEditRefusedOnBlindAsk, surfaceForCurrentSession, surfaceRememberNotApplied, } from './hitl/hitlHostSurface.js';
-export * from './hitl/toolApprovalWire.js';
+export { APPROVAL_DENY_SETTLED_BY_WORDS, ASK_ORIGIN_WORDS, RESPOND_DECISIONS, RETRACTED_CARD_DECISION_KIND, RULE_OFFERS_ABSENCE_REASONS, RULE_OFFER_BATCH_MEMBER_KINDS, RULE_OFFER_MATCHES, RULE_OFFER_UNCOVERED_REASONS, TOOL_APPROVAL_FRAME_KEYS_MIRROR, __resetSettledApprovalsForTests, _resetApprovalCardPortForTest, answerCarriage, answerPayloadFor, approvalBoundGrantsDetail, approvalCardFactsOfFrame, approvalCardFactsOfGeneric, approvalCardFactsOfV1, approvalCardFactsOfV1Frame, approvalCardPortFor, approvalCardPortMisses, approvalCardPortMissesFor, approvalIsMandated, approvalPriorCardsDetail, approvalSupersedesDetail, askProbeReasonDetail, claimApprovalCard, classifierNoRulingDetail, decisionAttributionKeyOf, hasApprovalCardPort, hasApprovalCardPortFor, installApprovalCardPort, installApprovalCardPortFor, isFromSubagent, isToolApprovalFrame, isToolApprovalGate, isToolApprovalRespondReplayed, joinApprovalHolder, observeApprovalAnswerCommitted, readApprovalBoundGrants, readApprovalCardWord, readApprovalClassifierNoRuling, readApprovalDenySettledBy, readApprovalMandate, readApprovalRememberRefused, readBoundGrantEntry, readDenialLimitFallback, readRuleOfferSupply, readRuleOffers, readToolApprovalRespondAck, readToolApprovalRespondParking, rememberRefusalOf, structurallyEqual, surfaceApprovalCard, surfaceFsApprovalAndDecide, surfaceToolApprovalFrameAndRespond, toolNameIsFsWrite, toolNameIsShellExec, toolPermissionRequestAskBits } from './hitl/toolApprovalWire.js';
 export * from './hitl/approvalCardReading.js';
 export * from './hitl/approvalCardReasons.js';
+export { approvalRequestFrameReadingOf, APPROVAL_REQUEST_FRAME_UNREADABLE_WHYS } from './hitl/approvalRequestFrameReading.js';
 export { askClassReasonOf, askClassReasonsOf } from './hitl/askClassPair.js';
 export * from './hitl/editedRuleTextPrecheck.js';
 export * from './coreValuePorts.js';
@@ -269,7 +279,7 @@ export { ASK_PARK_AUTO_REOPEN_BLOCKS, askParkAutoReopenBlockedContent, askParkAu
 export { HITL_DECISION_FAMILIES, HITL_DECISION_NOT_APPLIED_CAUSES, HITL_DECISION_NOT_SENT_CAUSES, HITL_DECISION_UNCONFIRMED_CAUSES, sendHitlDecision, hitlDecisionOutcomeContent, } from './hitl/decisionSend.js';
 export { PLAN_REVIEW_QUESTION_ID_PREFIX, REOPEN_ID_TAIL, approvalCallKey, askGateQuestionId, planReviewQuestionId, liveFrameCallKey, armedKeyFromQuestionId, } from './hitl/gateIdentity.js';
 export { _resetArmedGateRegistryForTest, _setGateArmedWaitMsForTest, clearArmedGate, gateArmedWaitMs, notePlanReviewAnswered, onGateArmed, planReviewArmedKey, registerArmedGate, registerArmedGateFor, registerArmedGateFromQuestionId, registerArmedGateFromQuestionIdFor, waitForGateArmed, wasGateArmed, wasGateArmedFor, } from './hitl/armedGateRegistry.js';
-export * from './hitl/parkOwnership.js';
+export { askQuestionsFromPending, isHitlSafetyErrorLike, pendingRowIsOwnedByThisSession, pendingRowOwnershipOf, } from './hitl/parkOwnership.js';
 export * from './hitl/parkRowBirthWait.js';
 export * from './hitl/approvalDecisionNoteAudit.js';
 export * from './hitl/askParkRowRouting.js';
@@ -291,11 +301,14 @@ export { MODE_ARBITRATION, automaticAnswerVerdict, mandatedApprovalDetailOf, cro
 export { standingRowsOf, rememberOfferable, localAllowRuleEnforceable, } from './hitl/standingRows.js';
 export { classifyDecisionRefusal, liveAskPendingReading, decisionRefusalClosesOut, undeliverableDecisionContent, decideRowUnrevivableNotice, decisionRefusalAskReading, readDecisionRefusalReading, } from './hitl/decisionRefusal.js';
 export { decisionGrantChangedContent } from './hitl/decisionConflict.js';
+export { decideFailureNote } from './decideFailureNote.js';
+export { decisionAnswerInvalidContent } from './hitl/decisionConflict.js';
 export { noAllowCauseOf } from './hitl/noAllowCause.js';
 export { policyDenyReason } from './hitl/frameRouter.js';
 export { readApprovalAllowRuleShadow, approvalAllowRuleShadowed, allowRuleShadowSentence, } from './hitl/allowRuleShadow.js';
 export { projectCrashConverged } from './hitl/crashConverged.js';
 export { checkpointQueueRowSortOf } from './hitl/approvalQueueRow.js';
+export { subagentSourceSessionOf } from './hitl/subagentSource.js';
 export * from './hitl/crashConvergedNotice.js';
 export { approvalCompleteParked } from './hitl/approvalCompleteParked.js';
 export { approvalCompleteCauseOf } from './hitl/approvalEndingCause.js';
@@ -323,6 +336,8 @@ export * from './agentSession/contract.js';
 export * from './agentSession/backgroundView.js';
 export { readAssistantInbox } from './assistantInbox.js';
 export { checkpointRowVerdictOf } from './checkpointRowVerdict.js';
+export { checkpointRowBarOf, checkpointRowBarSentence } from './checkpointRowVerdict.js';
+export { parkedUnresumableRowsOf, parkedUnresumableLine } from './hitl/parkedUnresumable.js';
 export { checkpointRequirementsDamagedOf } from './checkpointRowVerdict.js';
 export { READ_CREDENTIAL_NOT_ACCEPTED_NOTICE, isReadCredentialRefusal } from './readCredentialRefusal.js';
 export { readEngineAgentRegistry, isEngineAgentRegistryListingSuperseded } from './agentSession/engineAgentRegistryRead.js';
@@ -358,5 +373,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 { sessionEngineBindingFor, commitSessionEngine, readSessionEngine, sessionDispatchTarget, sessionDispatchRefusedFor } from './sessionEngine.js';
 export { foldSessionPlacement } from './deviceRebind.js';

package/dist/liveModelCatalog.d.ts

@@ -23,6 +23,7 @@ export interface LiveModelCatalog {
     droppedEntries?: readonly LiveModelDroppedEntry[];
     candidateRejected?: unknown;
     modelPlane?: {} | null;
+    aliases?: {} | null;
 }
 export declare function setLiveModelCatalog(next: LiveModelCatalog | null): void;
 export declare function setLiveModelCatalogRefresher(fn: (() => Promise<LiveModelCatalog | null>) | null): void;
@@ -51,12 +52,12 @@ export declare function effortLevelHonored(reading: EffortLevelsReading, level:
 export declare function liveDefaultModelName(): string | null;
 export type ModelAcceptanceReading = {
     readonly verdict: 'accepted';
-    readonly why: 'listed';
+    readonly why: 'listed' | 'aliased';
     readonly model: string;
     readonly defaultModel?: string;
 } | {
     readonly verdict: 'refused';
-    readonly why: 'not_listed' | 'disabled';
+    readonly why: 'not_listed' | 'disabled' | 'not_at_mentionable';
     readonly model: string;
     readonly defaultModel?: string;
 } | {
@@ -118,6 +119,7 @@ export type ModelPlaneReading = {
     readonly kind: 'unreadable';
 };
 export declare function modelPlaneOf(catalog?: LiveModelCatalog | null): ModelPlaneReading;
+export declare function modelPlaneSentence(reading: ModelPlaneReading, lang?: UiLanguage): string | undefined;
 export declare function modelCandidateRejectedContent(reading: ModelCandidateRejectedReading, lang?: UiLanguage): string | undefined;
 export interface RoutePairingVerdict {
     verdict: 'ok' | 'broken' | 'unknown';

package/dist/liveModelCatalog.js

@@ -189,6 +189,45 @@ function rowIdentityUnreadable(row) {
         return true;
     }
 }
+function aliasesOf(cat) {
+    const ALIASES_ABSENT = Object.freeze({ kind: 'absent' });
+    const ALIASES_UNREADABLE = Object.freeze({ kind: 'unreadable' });
+    try {
+        const d = Object.getOwnPropertyDescriptor(cat, 'aliases');
+        if (d === undefined)
+            return ALIASES_ABSENT;
+        if (!Object.hasOwn(d, 'value'))
+            return ALIASES_UNREADABLE;
+        const raw = d.value;
+        if (raw === undefined)
+            return ALIASES_ABSENT;
+        if (!Array.isArray(raw))
+            return ALIASES_UNREADABLE;
+        const n = ownDataOf(raw, 'length');
+        if (typeof n !== 'number' || !Number.isSafeInteger(n) || n < 0)
+            return ALIASES_UNREADABLE;
+        const entries = [];
+        for (let i = 0; i < n; i += 1) {
+            const ed = Object.getOwnPropertyDescriptor(raw, String(i));
+            if (ed === undefined || !Object.hasOwn(ed, 'value'))
+                return ALIASES_UNREADABLE;
+            const e = ed.value;
+            if (e === null || typeof e !== 'object' || !isPlainRecord(e))
+                return ALIASES_UNREADABLE;
+            const nd = Object.getOwnPropertyDescriptor(e, 'name');
+            if (nd === undefined || !Object.hasOwn(nd, 'value') || typeof nd.value !== 'string' || nd.value.length === 0)
+                return ALIASES_UNREADABLE;
+            const bit = atMentionBitOf(e);
+            if (bit === 'malformed' || bit === 'unreadable')
+                return ALIASES_UNREADABLE;
+            appendOwnElement(entries, Object.freeze({ name: nd.value, bit }));
+        }
+        return Object.freeze({ kind: 'listed', entries: Object.freeze(entries) });
+    }
+    catch {
+        return ALIASES_UNREADABLE;
+    }
+}
 export function modelAcceptanceOf(model, catalog = getLiveModelCatalog()) {
     const name = typeof model === 'string' && model.length > 0 ? model : undefined;
     try {
@@ -211,22 +250,45 @@ export function modelAcceptanceOf(model, catalog = getLiveModelCatalog()) {
                 defaultModel = undefined;
         }
         const withDefault = defaultModel === undefined ? {} : { defaultModel };
+        const cannotSay = () => Object.freeze({ verdict: 'unknown', why: 'catalog_unreadable', model: name });
         const reservedReading = () => Object.freeze({ verdict: 'unknown', why: 'reserved_word', model: name, ...withDefault });
-        if (reserved)
-            return reservedReading();
-        const row = liveModelRowOf(catalog, name);
-        if (row !== undefined) {
-            const normalized = ownDataOf(row, 'name');
-            if (typeof normalized !== 'string' || normalized.length === 0)
-                return Object.freeze({ verdict: 'unknown', why: 'catalog_unreadable', model: name });
-            if (isReservedModelWord(normalized))
+        const notMentionable = () => Object.freeze({ verdict: 'refused', why: 'not_at_mentionable', model: name, ...withDefault });
+        const byRow = (row) => {
+            if (ownDataOf(row, 'enabled') === false)
+                return Object.freeze({ verdict: 'refused', why: 'disabled', model: name, ...withDefault });
+            const bit = atMentionBitOf(row);
+            if (bit === 'refused')
+                return notMentionable();
+            if (bit === 'malformed' || bit === 'unreadable')
+                return cannotSay();
+            return Object.freeze({ verdict: 'accepted', why: 'listed', model: name, ...withDefault });
+        };
+        const aliases = aliasesOf(catalog);
+        if (aliases.kind === 'absent') {
+            if (reserved)
                 return reservedReading();
-            return ownDataOf(row, 'enabled') === false
-                ? Object.freeze({ verdict: 'refused', why: 'disabled', model: name, ...withDefault })
-                : Object.freeze({ verdict: 'accepted', why: 'listed', model: name, ...withDefault });
+            const row = liveModelRowOf(catalog, name);
+            if (row !== undefined) {
+                const normalized = ownDataOf(row, 'name');
+                if (typeof normalized !== 'string' || normalized.length === 0)
+                    return cannotSay();
+                if (isReservedModelWord(normalized))
+                    return reservedReading();
+                return byRow(row);
+            }
+        }
+        else {
+            const row = rows.find((r) => ownDataOf(r, 'name') === name);
+            if (row !== undefined)
+                return byRow(row);
+            if (aliases.kind === 'unreadable')
+                return cannotSay();
+            const alias = aliases.entries.find((a) => a.name === name);
+            if (alias !== undefined)
+                return alias.bit === 'refused' ? notMentionable() : Object.freeze({ verdict: 'accepted', why: 'aliased', model: name, ...withDefault });
         }
         if (rows.some(rowIdentityUnreadable))
-            return Object.freeze({ verdict: 'unknown', why: 'catalog_unreadable', model: name });
+            return cannotSay();
         const dropped = droppedModelEntriesOf(catalog);
         if (droppedDisabledNamed(dropped, name))
             return Object.freeze({ verdict: 'refused', why: 'disabled', model: name, ...withDefault });
@@ -246,7 +308,7 @@ export function modelNotServedNotice(reading, lang) {
         if (ownDataOf(reading, 'verdict') !== 'refused')
             return undefined;
         const why = ownDataOf(reading, 'why');
-        if (why !== 'not_listed' && why !== 'disabled')
+        if (why !== 'not_listed' && why !== 'disabled' && why !== 'not_at_mentionable')
             return undefined;
         const model = ownDataOf(reading, 'model');
         const shown = typeof model === 'string' && model.length > 0 ? quoteUntrustedForSentence(model, NOT_SERVED_NAME_MAX) : undefined;
@@ -254,6 +316,11 @@ export function modelNotServedNotice(reading, lang) {
             return undefined;
         const dm = ownDataOf(reading, 'defaultModel');
         const fallback = typeof dm === 'string' && dm.length > 0 ? quoteUntrustedForSentence(dm, NOT_SERVED_NAME_MAX) : undefined;
+        if (why === 'not_at_mentionable') {
+            return fallback === undefined
+                ? renderMessage(msg('model.notMentionable.noDefault', { model: shown }), lang)
+                : renderMessage(msg('model.notMentionable.withDefault', { model: shown, default: fallback }), lang);
+        }
         return fallback === undefined
             ? renderMessage(msg('model.notServed.noDefault', { model: shown }), lang)
             : renderMessage(msg('model.notServed.withDefault', { model: shown, default: fallback }), lang);
@@ -420,6 +487,24 @@ export function modelPlaneOf(catalog = getLiveModelCatalog()) {
         return unreadable;
     }
 }
+export function modelPlaneSentence(reading, lang) {
+    try {
+        if (reading === null || typeof reading !== 'object' || Array.isArray(reading))
+            return undefined;
+        if (ownDataOf(reading, 'kind') !== 'read')
+            return undefined;
+        const served = ownDataOf(reading, 'servedTable');
+        const stance = ownDataOf(reading, 'catalog');
+        if (served !== 'env')
+            return undefined;
+        if (stance !== 'absent' && stance !== 'refused')
+            return undefined;
+        return renderMessage(msg('model.catalog.envServed', { stance }), lang);
+    }
+    catch {
+        return undefined;
+    }
+}
 const CONFIG_DOMAIN_WORD = /^[a-z][a-z0-9_.-]{0,63}$/;
 export function modelCandidateRejectedContent(reading, lang) {
     try {
@@ -467,6 +552,7 @@ export function readLiveModelCatalog(body) {
         const droppedKey = envelopeKey(body, 'droppedEntries');
         const candidateKey = envelopeKey(body, 'candidateRejected');
         const planeKey = envelopeKey(body, 'modelPlane');
+        const aliasesKey = envelopeKey(body, 'aliases');
         const raw = modelsKey.present ? modelsKey.value : undefined;
         if (!Array.isArray(raw))
             return unreadableCatalog('models_not_array');
@@ -479,7 +565,7 @@ export function readLiveModelCatalog(body) {
         let unreadableRows = 0;
         for (let i = 0; i < len; i += 1) {
             const d = Object.getOwnPropertyDescriptor(raw, String(i));
-            const row = d !== undefined && Object.hasOwn(d, 'value') ? liveModelRowCopy(d.value) : undefined;
+            const row = d !== undefined && Object.hasOwn(d, 'value') ? modelRowTransitCopy(d.value) : undefined;
             if (row === undefined || names.has(row.name)) {
                 unreadableRows += 1;
                 continue;
@@ -504,12 +590,60 @@ export function readLiveModelCatalog(body) {
             out.candidateRejected = frozenJsonCopyOf(candidateKey.value) ?? null;
         if (planeKey.present && planeKey.value !== undefined)
             out.modelPlane = frozenJsonCopyOf(planeKey.value) ?? null;
+        if (aliasesKey.present && aliasesKey.value !== undefined)
+            out.aliases = aliasesTransitCopy(aliasesKey.value);
         return Object.freeze({ kind: 'read', catalog: Object.freeze(out), unreadableRows, ...(defaultModelMalformed ? { defaultModelMalformed: true } : {}) });
     }
     catch {
         return unreadableCatalog('unreadable');
     }
 }
+function aliasesTransitCopy(v) {
+    const copy = frozenJsonCopyOf(v);
+    if (copy === undefined)
+        return null;
+    const before = aliasesOf({ aliases: v });
+    const after = aliasesOf({ aliases: copy });
+    if (before.kind !== after.kind)
+        return null;
+    if (before.kind === 'listed' && after.kind === 'listed') {
+        if (before.entries.length !== after.entries.length)
+            return null;
+        for (let i = 0; i < before.entries.length; i += 1) {
+            const b = before.entries[i];
+            const a = after.entries[i];
+            if (b === undefined || a === undefined || b.name !== a.name || b.bit !== a.bit)
+                return null;
+        }
+    }
+    return copy;
+}
+const ACCEPTANCE_ROW_KEYS = Object.freeze(['id', 'enabled', 'atMentionable']);
+function modelRowTransitCopy(row) {
+    const copy = liveModelRowCopy(row);
+    if (copy === undefined || row === null || typeof row !== 'object')
+        return copy;
+    let restated;
+    for (const key of ACCEPTANCE_ROW_KEYS) {
+        if (Object.hasOwn(copy, key))
+            continue;
+        let value;
+        try {
+            const d = Object.getOwnPropertyDescriptor(row, key);
+            if (d === undefined)
+                continue;
+            value = Object.hasOwn(d, 'value') ? (d.value === undefined ? undefined : (frozenJsonCopyOf(d.value) ?? null)) : null;
+        }
+        catch {
+            value = null;
+        }
+        if (value === undefined)
+            continue;
+        restated ??= { ...copy };
+        Object.defineProperty(restated, key, { value, enumerable: true, writable: true, configurable: true });
+    }
+    return restated === undefined ? copy : Object.freeze(restated);
+}
 function droppedEntriesCopy(v) {
     if (!Array.isArray(v))
         return frozenJsonCopyOf(v) ?? null;
@@ -544,23 +678,27 @@ export function liveDefaultModelOf(catalog = getLiveModelCatalog()) {
         return Object.freeze({ kind: 'unknown', why: 'unreadable' });
     }
 }
+function atMentionBitOf(o) {
+    const d = Object.getOwnPropertyDescriptor(o, 'atMentionable');
+    if (d === undefined)
+        return 'not_governed';
+    if (!(Object.hasOwn(d, 'value')))
+        return 'unreadable';
+    if (d.value === undefined)
+        return 'not_governed';
+    if (d.value === true)
+        return 'allowed';
+    if (d.value === false)
+        return 'refused';
+    return 'malformed';
+}
 export function atMentionOf(model, catalog = getLiveModelCatalog()) {
     try {
         const target = targetRowOf(model, catalog);
         if (target.kind !== 'row')
             return Object.freeze({ kind: 'unknown', why: target.why });
-        const d = Object.getOwnPropertyDescriptor(target.row, 'atMentionable');
-        if (d === undefined)
-            return Object.freeze({ kind: 'not_governed' });
-        if (!(Object.hasOwn(d, 'value')))
-            return Object.freeze({ kind: 'unknown', why: 'unreadable' });
-        if (d.value === undefined)
-            return Object.freeze({ kind: 'not_governed' });
-        if (d.value === true)
-            return Object.freeze({ kind: 'allowed' });
-        if (d.value === false)
-            return Object.freeze({ kind: 'refused' });
-        return Object.freeze({ kind: 'unknown', why: 'malformed' });
+        const bit = atMentionBitOf(target.row);
+        return bit === 'malformed' || bit === 'unreadable' ? Object.freeze({ kind: 'unknown', why: bit }) : Object.freeze({ kind: bit });
     }
     catch {
         return Object.freeze({ kind: 'unknown', why: 'unreadable' });

package/dist/localEngineJudge.d.ts

@@ -0,0 +1,75 @@
+import { type EngineIdentityView } from './engineIdentity.js';
+import type { UiLanguage } from './env/uiLanguage.js';
+export interface LocalEnginePlanFingerprint {
+    readonly group: string;
+    readonly fingerprint: string;
+}
+export interface LocalEngineAnchorReading {
+    readonly pid: number;
+    readonly port: number;
+    readonly identity: EngineIdentityView;
+    readonly planFingerprints?: readonly LocalEnginePlanFingerprint[];
+    readonly logPath?: string;
+}
+export interface LocalEnginePlanDrift {
+    readonly group: string;
+    readonly drift: 'same' | 'different' | 'unknown';
+}
+export type LocalEngineAnchorPidState = 'gone' | 'alive' | 'recycled' | 'unknown';
+export type LocalEngineDataRootRelation = 'same' | 'different' | 'unknown';
+export interface LocalEngineJudgeInput {
+    readonly anchor: unknown;
+    readonly anchorPid: LocalEngineAnchorPidState;
+    readonly health: object | null;
+    readonly dataRootRelation: LocalEngineDataRootRelation;
+    readonly ownVersion: string | undefined;
+}
+export interface LocalEngineRef {
+    readonly pid: number;
+    readonly port: number;
+    readonly identity: EngineIdentityView;
+    readonly version?: string;
+}
+export interface LocalEngineAnchoredProcess {
+    readonly pid: number;
+    readonly startedAt?: number;
+}
+export type LocalEngineVerdict = {
+    readonly kind: 'none';
+    readonly blocked?: 'high-water-unreadable';
+} | {
+    readonly kind: 'unanswered';
+    readonly pid: number;
+    readonly startedAt?: number;
+    readonly reason: 'no-answer' | 'unverifiable';
+} | {
+    readonly kind: 'stranger';
+    readonly mismatch: 'pid' | 'generation' | 'data-root';
+    readonly anchored: LocalEngineAnchoredProcess | null;
+} | {
+    readonly kind: 'draining';
+    readonly engine: LocalEngineRef;
+    readonly deadlineAt: number;
+} | {
+    readonly kind: 'attach' | 'version-unknown';
+    readonly engine: LocalEngineRef;
+} | {
+    readonly kind: 'ahead';
+    readonly engine: LocalEngineRef;
+    readonly running: string;
+    readonly own: string;
+    readonly servesWhileWaiting: boolean;
+} | {
+    readonly kind: 'behind';
+    readonly engine: LocalEngineRef | null;
+    readonly running: string;
+    readonly own: string;
+    readonly source: 'running' | 'high-water';
+};
+export type LocalEngineUpgradePath = 'cli-update' | 'app-update';
+export declare function localEngineAnchorOf(raw: unknown): LocalEngineAnchorReading | null;
+export declare function localEnginePlanDriftOf(anchor: unknown, ownPlan: readonly LocalEnginePlanFingerprint[]): readonly LocalEnginePlanDrift[];
+export declare function sameLocalEngineInstance(x: object, y: object, anchorPidAlive: boolean): boolean;
+export declare function judgeLocalEngine(input: LocalEngineJudgeInput): LocalEngineVerdict;
+export declare function localEngineLaneOf(verdict: LocalEngineVerdict): 'self-spawned' | undefined;
+export declare function localEngineVerdictSentence(verdict: LocalEngineVerdict, upgrade: LocalEngineUpgradePath | undefined, lang?: UiLanguage): string | undefined;