@sema-agent/client-core 0.83.6 → 0.84.0

package/dist/index.d.ts

@@ -1,9 +1,10 @@
 export * from './seam.js';
 export * from './workflow.js';
-export * from './notifications.js';
+export { _resetEngineTaskNotificationForTest, _resetNotificationQueuePortForTest, _setWatcherTimingForTest, _tickWatchOnceForTest, classifyHookFailureFrame, classifyHookNoticeFrame, deriveNotificationResidualLines, dropQueuedNotificationsForRun, enqueueBgChildNotification, enqueueEngineWorkflowNotification, enqueuePlanReviewOutcome, HOOK_NOTICE_WARN_PREFIX, hookNoticeLastCheckText, installBgTaskStatusProbe, installNotificationQueuePort, installWorkflowStatusProbe, isEngineWorkflowNotified, isHookNoticeFrame, isOwnWorkflowRun, isTaskNotificationObjective, isWorkflowCompletionCardEnqueued, listOwnWorkflowRuns, markEngineWorkflowNotified, normalizeTaskNotification, noteOwnWorkflowRun, noteWorkflowCompletionCardEnqueued, notificationDropCounters, notificationQueuePortMisses, outstandingAbandonedCount, outstandingBgTaskPrompt, outstandingDeliverableWorkflowCount, outstandingWorkflowCount, parseTranscriptNotificationSeeds, registerOutstandingBgTask, registerOutstandingWorkflowRun, renderTaskNotificationXml, splitApiErrorSupplement, subscribeOutstandingWorkflows, taskNotificationDedupKey, taskNotificationDedupKeyFromWire, taskNotificationDeliverySupplement, } from './notifications.js';
+export type { EngineWorkflowCompletion, GoalHookNotice, HookEntryType, HookFailureNotice, HookFailureReason, HookFailureVerdict, HookNoticeReason, HookNoticeVerdict, HookNoticeWire, NotificationDropCounters, NotificationQueuePort, QueuedCommandLike, TaskNotificationFields, TranscriptNotificationSeeds, } from './notifications.js';
 export * from './peerFrames.js';
 export * from './steering.js';
-export * from './diagnostics.js';
+export type { DiagnosticsAttachment, } from './diagnostics.js';
 export * from './retryStatus.js';
 export * from './sessionMemoryStatus.js';
 export * from './memorySpecWire.js';
@@ -12,11 +13,13 @@ export * from './adapt/textSegmentAuthority.js';
 export * from './engineHttpTools.js';
 export * from './sdkWireTransit.js';
 export { SEMA_SEGMENT_ID_KEY } from './adapt/textStream.js';
-export * from './subagentContentStore.js';
+export { __resetSubagentContentStoreConfigForTests, __resetSubagentOwnerLedgerForTests, clearSubagentContent, coerceOutput, configureSubagentContentStore, getBgParentRun, getBgParentRunOwner, getBgTerminalFacts, getSubagentContentSnapshot, isOwnEngineRun, parentToolCallIdOf, planSubagentViewSlots, publishSubagentContentEvent, pushSubagentLocalEcho, recordBgParentRun, recordBgTerminalFacts, recordOwnEngineRun, recordSubagentOwner, recordSubagentOwnerFromProgress, registerSubagentAlias, settleSubagentContent, SUBAGENT_CONTENT_STORE_DEFAULTS, subagentContentStoreConfig, subagentOwnerSessionConflicts, subscribeSubagentContent, } from './subagentContentStore.js';
+export type { BgTerminalFacts, SubagentContentEvent, SubagentContentItem, SubagentContentSnapshot, SubagentContentStoreConfig, SubagentOwnerRecord, SubagentOwnerSessionConflict, SubagentViewSlot, } from './subagentContentStore.js';
 export * from './engineAgentPanelStore.js';
 export * from './engineAgentAbsence.js';
 export * from './fleetAgentPanelProjection.js';
-export * from './liveQuestionStore.js';
+export { _resetLiveQuestionStore, hasLocalQuestionResponder, hasQuestionOverlay, hasQuestionOverlayFor, onQuestionFrame, onQuestionFrameFor, publishQuestionFrame, publishQuestionFrameFor, registerLocalQuestionResponder, respondToQuestion, setQuestionRespond, } from './liveQuestionStore.js';
+export type { AskQuestion, AskQuestionOption, QuestionAnswer, QuestionFrame, } from './liveQuestionStore.js';
 export * from './engineInlineTaskStats.js';
 export * from './printToolResultFrame.js';
 export * from './engineCapsCache.js';
@@ -67,7 +70,8 @@ export * from './sseIdleTriage.js';
 export * from './engineWireSdk.js';
 export * from './classifierVerdictWire.js';
 export { stripSystemReminderBlocks, unwrapSystemReminder } from './systemReminderTag.js';
-export * from './engineErrorCodes.js';
+export { ACTIVE_RUN_BUSY_ERROR_CODE, asModelFallbackReason, CAPABILITY_SELF_ORCHESTRATION_REQUIRED, CONFIG_DELEGATION_ENTRY_CAPS, CONFIG_LIMIT_INVALID, CONFIG_LIMIT_UNKNOWN_KEY, CONFIG_MEMORY_PROJECT_KEY_SPELLING, CONFIG_MEMORY_WRITE_SCOPE_MISMATCH, CONFIG_REFUSAL_CODES, CONFIG_STRATEGY_FIND_LIMIT_INVALID, CONFIG_STRATEGY_MAX_SIZE_INVALID, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, DELEGATION_CAP_CODES, DELEGATION_CONCURRENCY_CAP, DELEGATION_SESSION_CAP, delegationCapDispositionOf, DRAINING_ERROR_CODE, ENGINE_STOP_REASONS, engineStopReasonToCc, ENV_LIFETIME_EXPIRED, GATE_PARKED_ERROR_CODE, isConfigRefusalCode, isDelegationCapCode, isInterruptedToolEndCode, isLimitsExceededCode, isRewindFamilyCode, isWorkflowParkRefusalCode, LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, MCP_SERVER_REVOKED, MODEL_FALLBACK_INHERIT_NO_TIER_BINDING, OUTPUT_INVALID, 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, SCENARIO_NOT_ALLOWED_ERROR_CODE, STOP_CONFLICT_CODES, STREAM_MAX_DURATION, TOOL_END_INTERRUPTED_NEVER_STARTED, TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN, USAGE_WINDOW_EXHAUSTED, WORKFLOW_PARK_REFUSAL_CODES, } from './engineErrorCodes.js';
+export type { DelegationCapDisposition, ModelFallbackReason, } from './engineErrorCodes.js';
 export * from './agentsWireCaps.js';
 export * from './attachmentsWireCaps.js';
 export * from './clientContextWireCaps.js';
@@ -115,20 +119,23 @@ export * from './limitsWire.js';
 export * from './interactiveToolsWire.js';
 export * from './headlessPermissionModeWire.js';
 export * from './headlessReconnectWire.js';
-export * from './fleet/fleetProjection.js';
+export { coerceTaskStatus, coerceWorkflowStatus, CONTROL_TOOL_VERBS, FLEET_TASK_ROW_KEYS_NOT_PROJECTED, FLEET_TASK_ROW_WIRE_KEYS, FLEET_TASK_VIEW_KEYS, FLEET_WORKFLOW_ROW_KEYS_NOT_PROJECTED, FLEET_WORKFLOW_ROW_WIRE_KEYS, FLEET_WORKFLOW_VIEW_KEYS, projectDescription, projectTasks, projectWorkflows, TERMINAL_FLEET_TASK_STATUSES, wireResumable, wireRowUsage, } from './fleet/fleetProjection.js';
+export type { FleetRowUsage, FleetTaskStatus, FleetTaskView, FleetWorkflowView, NotProjectedEntry, ProjectTasksOptions, } from './fleet/fleetProjection.js';
 export * from './fleet/fleetLedger.js';
 export * from './fleet/workflowSizeWarning.js';
 export * from './subagent/engineDelegatedPrompt.js';
 export * from './subagent/engineRowStopGate.js';
 export * from './subagent/engineSubagentOutput.js';
 export * from './subagent/engineSubagentSteer.js';
-export * from './subagent/engineSubagentResume.js';
+export { __resetRetainWithoutWakeWarningForTests, auditRetainWithoutWake, classifySubagentResumeFailure, resolveOwnerRunId, resolveSubagentContinueTarget, resolveSubagentResumeContext, resumeSettledSubagent, SUBAGENT_RESUME_CAP, subagentResumeAvailable, } from './subagent/engineSubagentResume.js';
+export type { RetainWithoutWakeInput, RetainWithoutWakeVerdict, SubagentOwnerContext, SubagentResumeContext, SubagentResumeFacade, SubagentResumeFailureKind, SubagentResumeFailureVerdict, SubagentResumeOutcome, } from './subagent/engineSubagentResume.js';
 export * from './subagent/engineTaskHandleWire.js';
 export * from './subagent/engineCompactWire.js';
 export * from './subagent/engineSubagentTail.js';
-export * from './subagent/subagentOwnerAbsence.js';
+export { __resetBgOwnerAbsenceForTests, } from './subagent/subagentOwnerAbsence.js';
 export * from './engineSessionParam.js';
-export * from './engineWireTarget.js';
+export { engineWireTarget, engineWireTargetFor, installEngineWireTarget, installEngineWireTargetFor, } from './engineWireTarget.js';
+export type { EngineWireTarget, } from './engineWireTarget.js';
 export * from './principalWire.js';
 export * from './wireErrorTriage.js';
 export * from './resumeRefusalCopy.js';
@@ -143,20 +150,21 @@ export { ENGINE_FIRED_HOOK_EVENTS, PLUGIN_HOOK_DISPOSITIONS, PLUGIN_HOOK_REASONS
 export * from './liveInitToolFace.js';
 export * from './printInitToolFace.js';
 export * from './model/providerPresets.js';
-export * from './hitl/hitlBridge.js';
+export { __setDecideTimeoutRetryBudgetForTests, backendDeny, DecideTransportRetryExhaustedError, findPendingForTask, HitlBridge, HitlSafetyError, isPlanReviewModeAfter, makeHitlCanUseTool, PLAN_REVIEW_MODE_AFTER_WORDS, readDecideCurrentPending, readWireErrorCode, } from './hitl/hitlBridge.js';
+export type { ActiveGate, ApprovalsResourceLike, AskAnswer, AssistantResourceLike, DecideOperationEnd, DecideOperationEvent, DecideOperationIdentity, DecideOperationObserver, DecideOperationSpan, DecideOperationStart, FindPendingOutcome, GateCurrentPending, GatePrompt, HitlBackendDenyDecision, HitlBridgeOptions, HitlCanUseToolFn, HitlClientLike, HitlDecideDenyOutcome, HitlFailureStage, HitlPermissionDecisionLike, HitlSafetyCode, PlanReviewModeAfter, PlanReviewOutcome, } from './hitl/hitlBridge.js';
 export * from './hitl/suspendedReopen.js';
 export * from './hitl/approvalOutcomeNote.js';
 export * from './hitl/approvalResolution.js';
 export { toolEndOutputText, ENGINE_ABORT_TOOL_RESULT } from './hitl/frameRouter.js';
-export { isAskTool } from './hitl/frameRouter.js';
-export * from './hitl/hitlHostSurface.js';
+export { _resetHitlHostSurfaceForTest, 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, RULE_NOT_SENT_REJECTED_WARN_TEXT, RULE_NOT_SENT_WARN_TEXT, surfaceEditRefusedOnBlindAsk, surfaceForCurrentSession, surfaceRememberNotApplied, } from './hitl/hitlHostSurface.js';
+export type { ClassifierDenyContext, HitlHostSurface, HitlNotice, } from './hitl/hitlHostSurface.js';
 export * from './hitl/toolApprovalWire.js';
 export * from './hitl/editedRuleTextPrecheck.js';
 export * from './coreValuePorts.js';
 export * from './hitl/askGateWire.js';
 export * from './hitl/planReviewWire.js';
 export { PLAN_REVIEW_QUESTION_ID_PREFIX, REOPEN_ID_TAIL, approvalCallKey, askGateQuestionId, planReviewQuestionId, liveFrameCallKey, armedKeyFromQuestionId, } from './hitl/gateIdentity.js';
-export * from './hitl/armedGateRegistry.js';
+export { _resetArmedGateRegistryForTest, _setGateArmedWaitMsForTest, clearArmedGate, gateArmedWaitMs, notePlanReviewAnswered, onGateArmed, planReviewArmedKey, registerArmedGate, registerArmedGateFor, registerArmedGateFromQuestionId, waitForGateArmed, wasGateArmed, wasGateArmedFor, } from './hitl/armedGateRegistry.js';
 export * from './hitl/parkOwnership.js';
 export * from './hitl/parkRowBirthWait.js';
 export * from './hitl/approvalDecisionNoteAudit.js';
@@ -176,6 +184,8 @@ export * from './request/printNotification.js';
 export * from './seatContract.js';
 export * from './agentSession/contract.js';
 export * from './agentSession/backgroundView.js';
+export { readEngineAgentRegistry, isEngineAgentRegistryListingSuperseded } from './agentSession/engineAgentRegistryRead.js';
+export type { EngineAgentRegistryClient } from './agentSession/engineAgentRegistryRead.js';
 export * from './model/catalog.js';
 export * from './model/catalogLoader.js';
 export * from './model/providerAuth.js';

package/dist/index.js

@@ -1,9 +1,8 @@
 export * from './seam.js';
 export * from './workflow.js';
-export * from './notifications.js';
+export { _resetEngineTaskNotificationForTest, _resetNotificationQueuePortForTest, _setWatcherTimingForTest, _tickWatchOnceForTest, classifyHookFailureFrame, classifyHookNoticeFrame, deriveNotificationResidualLines, dropQueuedNotificationsForRun, enqueueBgChildNotification, enqueueEngineWorkflowNotification, enqueuePlanReviewOutcome, HOOK_NOTICE_WARN_PREFIX, hookNoticeLastCheckText, installBgTaskStatusProbe, installNotificationQueuePort, installWorkflowStatusProbe, isEngineWorkflowNotified, isHookNoticeFrame, isOwnWorkflowRun, isTaskNotificationObjective, isWorkflowCompletionCardEnqueued, listOwnWorkflowRuns, markEngineWorkflowNotified, normalizeTaskNotification, noteOwnWorkflowRun, noteWorkflowCompletionCardEnqueued, notificationDropCounters, notificationQueuePortMisses, outstandingAbandonedCount, outstandingBgTaskPrompt, outstandingDeliverableWorkflowCount, outstandingWorkflowCount, parseTranscriptNotificationSeeds, registerOutstandingBgTask, registerOutstandingWorkflowRun, renderTaskNotificationXml, splitApiErrorSupplement, subscribeOutstandingWorkflows, taskNotificationDedupKey, taskNotificationDedupKeyFromWire, taskNotificationDeliverySupplement, } from './notifications.js';
 export * from './peerFrames.js';
 export * from './steering.js';
-export * from './diagnostics.js';
 export * from './retryStatus.js';
 export * from './sessionMemoryStatus.js';
 export * from './memorySpecWire.js';
@@ -12,11 +11,11 @@ export * from './adapt/textSegmentAuthority.js';
 export * from './engineHttpTools.js';
 export * from './sdkWireTransit.js';
 export { SEMA_SEGMENT_ID_KEY } from './adapt/textStream.js';
-export * from './subagentContentStore.js';
+export { __resetSubagentContentStoreConfigForTests, __resetSubagentOwnerLedgerForTests, clearSubagentContent, coerceOutput, configureSubagentContentStore, getBgParentRun, getBgParentRunOwner, getBgTerminalFacts, getSubagentContentSnapshot, isOwnEngineRun, parentToolCallIdOf, planSubagentViewSlots, publishSubagentContentEvent, pushSubagentLocalEcho, recordBgParentRun, recordBgTerminalFacts, recordOwnEngineRun, recordSubagentOwner, recordSubagentOwnerFromProgress, registerSubagentAlias, settleSubagentContent, SUBAGENT_CONTENT_STORE_DEFAULTS, subagentContentStoreConfig, subagentOwnerSessionConflicts, subscribeSubagentContent, } from './subagentContentStore.js';
 export * from './engineAgentPanelStore.js';
 export * from './engineAgentAbsence.js';
 export * from './fleetAgentPanelProjection.js';
-export * from './liveQuestionStore.js';
+export { _resetLiveQuestionStore, hasLocalQuestionResponder, hasQuestionOverlay, hasQuestionOverlayFor, onQuestionFrame, onQuestionFrameFor, publishQuestionFrame, publishQuestionFrameFor, registerLocalQuestionResponder, respondToQuestion, setQuestionRespond, } from './liveQuestionStore.js';
 export * from './engineInlineTaskStats.js';
 export * from './printToolResultFrame.js';
 export * from './engineCapsCache.js';
@@ -65,7 +64,7 @@ export * from './sseIdleTriage.js';
 export * from './engineWireSdk.js';
 export * from './classifierVerdictWire.js';
 export { stripSystemReminderBlocks, unwrapSystemReminder } from './systemReminderTag.js';
-export * from './engineErrorCodes.js';
+export { ACTIVE_RUN_BUSY_ERROR_CODE, asModelFallbackReason, CAPABILITY_SELF_ORCHESTRATION_REQUIRED, CONFIG_DELEGATION_ENTRY_CAPS, CONFIG_LIMIT_INVALID, CONFIG_LIMIT_UNKNOWN_KEY, CONFIG_MEMORY_PROJECT_KEY_SPELLING, CONFIG_MEMORY_WRITE_SCOPE_MISMATCH, CONFIG_REFUSAL_CODES, CONFIG_STRATEGY_FIND_LIMIT_INVALID, CONFIG_STRATEGY_MAX_SIZE_INVALID, DECIDE_WORKFLOW_HOST_UNKNOWN, DECIDE_WORKFLOW_LANE_CODES, DECIDE_WORKFLOW_REMEMBER_UNSUPPORTED, DELEGATION_CAP_CODES, DELEGATION_CONCURRENCY_CAP, DELEGATION_SESSION_CAP, delegationCapDispositionOf, DRAINING_ERROR_CODE, ENGINE_STOP_REASONS, engineStopReasonToCc, ENV_LIFETIME_EXPIRED, GATE_PARKED_ERROR_CODE, isConfigRefusalCode, isDelegationCapCode, isInterruptedToolEndCode, isLimitsExceededCode, isRewindFamilyCode, isWorkflowParkRefusalCode, LIMITS_MAX_COST_EXCEEDED, LIMITS_MAX_TOKENS_EXCEEDED, LIMITS_MAX_TURNS_EXCEEDED, LIMITS_MAX_WALLTIME_EXCEEDED, MCP_SERVER_REVOKED, MODEL_FALLBACK_INHERIT_NO_TIER_BINDING, OUTPUT_INVALID, 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, SCENARIO_NOT_ALLOWED_ERROR_CODE, STOP_CONFLICT_CODES, STREAM_MAX_DURATION, TOOL_END_INTERRUPTED_NEVER_STARTED, TOOL_END_INTERRUPTED_OUTCOME_UNKNOWN, USAGE_WINDOW_EXHAUSTED, WORKFLOW_PARK_REFUSAL_CODES, } from './engineErrorCodes.js';
 export * from './agentsWireCaps.js';
 export * from './attachmentsWireCaps.js';
 export * from './clientContextWireCaps.js';
@@ -112,20 +111,20 @@ export * from './limitsWire.js';
 export * from './interactiveToolsWire.js';
 export * from './headlessPermissionModeWire.js';
 export * from './headlessReconnectWire.js';
-export * from './fleet/fleetProjection.js';
+export { coerceTaskStatus, coerceWorkflowStatus, CONTROL_TOOL_VERBS, FLEET_TASK_ROW_KEYS_NOT_PROJECTED, FLEET_TASK_ROW_WIRE_KEYS, FLEET_TASK_VIEW_KEYS, FLEET_WORKFLOW_ROW_KEYS_NOT_PROJECTED, FLEET_WORKFLOW_ROW_WIRE_KEYS, FLEET_WORKFLOW_VIEW_KEYS, projectDescription, projectTasks, projectWorkflows, TERMINAL_FLEET_TASK_STATUSES, wireResumable, wireRowUsage, } from './fleet/fleetProjection.js';
 export * from './fleet/fleetLedger.js';
 export * from './fleet/workflowSizeWarning.js';
 export * from './subagent/engineDelegatedPrompt.js';
 export * from './subagent/engineRowStopGate.js';
 export * from './subagent/engineSubagentOutput.js';
 export * from './subagent/engineSubagentSteer.js';
-export * from './subagent/engineSubagentResume.js';
+export { __resetRetainWithoutWakeWarningForTests, auditRetainWithoutWake, classifySubagentResumeFailure, resolveOwnerRunId, resolveSubagentContinueTarget, resolveSubagentResumeContext, resumeSettledSubagent, SUBAGENT_RESUME_CAP, subagentResumeAvailable, } from './subagent/engineSubagentResume.js';
 export * from './subagent/engineTaskHandleWire.js';
 export * from './subagent/engineCompactWire.js';
 export * from './subagent/engineSubagentTail.js';
-export * from './subagent/subagentOwnerAbsence.js';
+export { __resetBgOwnerAbsenceForTests, } from './subagent/subagentOwnerAbsence.js';
 export * from './engineSessionParam.js';
-export * from './engineWireTarget.js';
+export { engineWireTarget, engineWireTargetFor, installEngineWireTarget, installEngineWireTargetFor, } from './engineWireTarget.js';
 export * from './principalWire.js';
 export * from './wireErrorTriage.js';
 export * from './resumeRefusalCopy.js';
@@ -140,20 +139,19 @@ export { ENGINE_FIRED_HOOK_EVENTS, PLUGIN_HOOK_DISPOSITIONS, PLUGIN_HOOK_REASONS
 export * from './liveInitToolFace.js';
 export * from './printInitToolFace.js';
 export * from './model/providerPresets.js';
-export * from './hitl/hitlBridge.js';
+export { __setDecideTimeoutRetryBudgetForTests, backendDeny, DecideTransportRetryExhaustedError, findPendingForTask, HitlBridge, HitlSafetyError, isPlanReviewModeAfter, makeHitlCanUseTool, PLAN_REVIEW_MODE_AFTER_WORDS, readDecideCurrentPending, readWireErrorCode, } from './hitl/hitlBridge.js';
 export * from './hitl/suspendedReopen.js';
 export * from './hitl/approvalOutcomeNote.js';
 export * from './hitl/approvalResolution.js';
 export { toolEndOutputText, ENGINE_ABORT_TOOL_RESULT } from './hitl/frameRouter.js';
-export { isAskTool } from './hitl/frameRouter.js';
-export * from './hitl/hitlHostSurface.js';
+export { _resetHitlHostSurfaceForTest, 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, RULE_NOT_SENT_REJECTED_WARN_TEXT, RULE_NOT_SENT_WARN_TEXT, surfaceEditRefusedOnBlindAsk, surfaceForCurrentSession, surfaceRememberNotApplied, } from './hitl/hitlHostSurface.js';
 export * from './hitl/toolApprovalWire.js';
 export * from './hitl/editedRuleTextPrecheck.js';
 export * from './coreValuePorts.js';
 export * from './hitl/askGateWire.js';
 export * from './hitl/planReviewWire.js';
 export { PLAN_REVIEW_QUESTION_ID_PREFIX, REOPEN_ID_TAIL, approvalCallKey, askGateQuestionId, planReviewQuestionId, liveFrameCallKey, armedKeyFromQuestionId, } from './hitl/gateIdentity.js';
-export * from './hitl/armedGateRegistry.js';
+export { _resetArmedGateRegistryForTest, _setGateArmedWaitMsForTest, clearArmedGate, gateArmedWaitMs, notePlanReviewAnswered, onGateArmed, planReviewArmedKey, registerArmedGate, registerArmedGateFor, registerArmedGateFromQuestionId, waitForGateArmed, wasGateArmed, wasGateArmedFor, } from './hitl/armedGateRegistry.js';
 export * from './hitl/parkOwnership.js';
 export * from './hitl/parkRowBirthWait.js';
 export * from './hitl/approvalDecisionNoteAudit.js';
@@ -173,6 +171,7 @@ export * from './request/printNotification.js';
 export * from './seatContract.js';
 export * from './agentSession/contract.js';
 export * from './agentSession/backgroundView.js';
+export { readEngineAgentRegistry, isEngineAgentRegistryListingSuperseded } from './agentSession/engineAgentRegistryRead.js';
 export * from './model/catalog.js';
 export * from './model/catalogLoader.js';
 export * from './model/providerAuth.js';

package/dist/model/catalogLoader.js

@@ -1,10 +1,10 @@
 import { hostEnv } from '../hostEnv.js';
 import { resolveModelCatalog, } from './catalog.js';
-export const DEFAULT_CATALOG_SOURCES = [
+export const DEFAULT_CATALOG_SOURCES = Object.freeze([
     'https://raw.githubusercontent.com/sema-agent/sema-model-catalog/main/dist/catalog.json',
     'https://cdn.jsdelivr.net/gh/sema-agent/sema-model-catalog@main/dist/catalog.json',
-];
-export const CATALOG_DEFAULT_HOSTS = ['raw.githubusercontent.com', 'cdn.jsdelivr.net'];
+]);
+export const CATALOG_DEFAULT_HOSTS = Object.freeze(['raw.githubusercontent.com', 'cdn.jsdelivr.net']);
 export const CATALOG_SOURCES_ENV = 'SEMA_CATALOG_SOURCES';
 const DEFAULT_CATALOG_TIMEOUT_MS = 3500;
 const CATALOG_CACHE_RELATIVE_PATH = 'cache/model-catalog.json';

package/dist/model/tierVocabulary.js

@@ -1,4 +1,4 @@
-export const TIER_ORDER = ['ultra', 'max', 'pro', 'flash', 'lite'];
+export const TIER_ORDER = Object.freeze(['ultra', 'max', 'pro', 'flash', 'lite']);
 export const SURFACED_TIERS = ['max', 'pro', 'flash', 'lite'];
 export const CC_TIER_ALIASES = {
     fable: 'max',

package/dist/request/taskRequest.js

@@ -39,11 +39,11 @@ export const REQUEST_FIELD_MATRIX = [
     { field: 'reasoningEffort', lanes: ['interactive', 'print', 'utility'], live: false, why: '思考档位(sdk `TaskRequest.reasoningEffort` 七词闭集;上游对表外词 400 响亮拒 ⇒ 本层不预铸第二判官)。档位是请求级的位、与车道无关:交互面 = `/effort` 拨盘,无人值守面 = 档位旗。🔴 端交的必须是**档位词**:「思考 token 数」今天没有上游对位(见 `UPSTREAM_ABSENT_REQUEST_INTENTS` 的 `maxThinkingTokens`),别把一个数字折成档位词发出去', whyUtilityLane: '有座:side-channel 该用显式低档(省钱省时);与 model 同一条理由 —— 本车道上这两位都由壳显式给,不跟用户会话的拨盘走' },
     { field: 'model', lanes: ['interactive', 'print', 'utility'], live: false, why: '模型选择(sdk `TaskRequest.model`;交互面 = `/model` 中途换模型的拨盘,无人值守面 = 模型旗 / 部署缺省那一路,side-channel 面 = 壳显式挑的那一只)。三条车道都有来源、都是提交面。🔴 0.79.0 改口:修前「print 的模型走另一条路」这句理由被用户面实测证伪 —— 无人值守车道传了模型名却整键不上请求体,于是同一个坏名字在交互态被引擎 400 点名、在无人值守态却安静换成部署缺省并在首帧回显一个没生效的名字。一个**选择**类声明被静默丢掉,后果与收紧类声明被静默丢掉同形(端不读回执就以为生效)—— 与 `excludeTools` 补 print 座同律。本层原样透传、不预判模型名(名字的合法性归引擎,本层不铸第二判官)', whyUtilityLane: '有座:side-channel 显式挑便宜的那只模型(不跟用户会话的 `/model` 拨盘走)' },
     { field: 'images', lanes: ['interactive'], live: false, why: '贴图提交是交互动作,`-p` 的 stdin 没有图片块', whyUtilityLane: '无座:贴图是交互动作,side-channel 的提交体里没有图片块' },
-    { field: 'resumeAt/resumeAtMode/restoreFiles/rewindFiles/rewindFilesTo', lanes: ['interactive'], live: false, why: 'E18 `/rewind` 是交互命令;五键同生同灭(CC-145:core 6.0.0 起 both 臂发 restoreFiles,退役键 rewindFiles 只为旧读者留座不再铸;resumeAtMode 是 both/conversation 两臂恒带的排他截语义位)', whyUtilityLane: '无座:回退是交互命令,而 side-channel 是一次性的独立会话,没有可回退的历史' },
+    { field: 'resumeAt/resumeAtMode/restoreFiles/rewindFilesTo', lanes: ['interactive'], live: false, why: 'E18 `/rewind` 是交互命令;四键同生同灭(CC-145:core 6.0.0 起 both 臂发 restoreFiles;CC-223 起退役键 rewindFiles 不再有座 —— 交它按表外子键响亮拒;resumeAtMode 是 both/conversation 两臂恒带的排他截语义位)', whyUtilityLane: '无座:回退是交互命令,而 side-channel 是一次性的独立会话,没有可回退的历史' },
     { field: 'clientContext', lanes: ['interactive'], live: false, why: 'IANA 时区 + 可选邮箱 → core 本地化 `# Environment` 的 today;print 同样跑在用户机器上,缺席让引擎误标 (UTC)', gap: true, whyUtilityLane: '无座:本地化 today 的用途在用户会话的环境段,而 side-channel 的系统提示由壳整段给出 —— 这一列我判不准要不要(与本行 `gap` 同一条待办:要补先单独立项)' },
     { field: 'scratchpadDir', lanes: ['interactive'], live: true, why: '[816]③ per-session 暂存目录;print 也有 session,缺席让 `-p` 的工具写不进 exemptDir', gap: true, whyUtilityLane: '无座:per-session 暂存目录是给**工具**写的,零工具面上没人写' },
 ];
-export const LIVE_DEFAULT_FIELDS = [
+export const LIVE_DEFAULT_FIELDS = Object.freeze([
     'cwd',
     'additionalDirectories',
     'additionalReadDirectories',
@@ -54,7 +54,7 @@ export const LIVE_DEFAULT_FIELDS = [
     'suggestNextPrompts',
     'compactionModel',
     'sessionId(三态解析)',
-];
+]);
 export const TASK_REQUEST_OMISSION_CAUSES = Object.freeze([
     'upstream_absent',
     'other_channel',
@@ -125,7 +125,7 @@ const INPUT_KEY_ROUTES = {
     memoryCapture: row('memoryCapture'),
     memory: row('memory'),
     approverPosture: row('approverPosture'),
-    rewind: row('resumeAt/resumeAtMode/restoreFiles/rewindFiles/rewindFilesTo'),
+    rewind: row('resumeAt/resumeAtMode/restoreFiles/rewindFilesTo'),
     repo: row('repo'),
     council: row('council'),
     debate: row('debate'),
@@ -585,11 +585,12 @@ export function assembleTaskRequest(input, lane) {
     refuseBadMaxTokens(maxTokensIn);
     refuseBadOutputRetries(outputRetriesIn);
     const rewindRoute = INPUT_KEY_ROUTES.rewind;
+    const RETIRED_REWIND_FILES_KEY = 'rewindFiles';
     const REWIND_KEYS = rewindRoute.via === 'matrix' ? rewindRoute.field.split('/') : [];
     const rewindIn = i.rewind;
     if (present(rewindIn) && (typeof rewindIn !== 'object' || Array.isArray(rewindIn))) {
         throw new TypeError(`buildTaskRequest: rewind 只接受对象或缺席(undefined/null)—— 收到 ${coarseShape(rewindIn)}。` +
-            '它是五个具名请求键(resumeAt / resumeAtMode / restoreFiles / rewindFiles / rewindFilesTo)的合写位,不是任意展开口。错误文本只报形状,不回显值。');
+            '它是四个具名请求键(resumeAt / resumeAtMode / restoreFiles / rewindFilesTo)的合写位,不是任意展开口。错误文本只报形状,不回显值。');
     }
     const rewindObj = present(rewindIn) ? rewindIn : {};
     const rewindWire = {};
@@ -632,14 +633,23 @@ export function assembleTaskRequest(input, lane) {
             continue;
         unknownKeys.push(`settings.${sub}`);
     }
+    let retiredRewindFiles = false;
     for (const sub of Object.keys(rewindObj)) {
         if (REWIND_KEYS.includes(sub))
             continue;
         const stray = rewindObj[sub];
         if (!present(stray))
             continue;
+        if (sub === RETIRED_REWIND_FILES_KEY)
+            retiredRewindFiles = true;
         unknownKeys.push(`rewind.${sub}`);
     }
+    if (retiredRewindFiles) {
+        throw new TypeError('buildTaskRequest: "rewind.rewindFiles" 是退役键(引擎 core 6.0.0 起退役:「逐轮捕获」那一义被引擎忽略 —— 文件首触追踪恒开,' +
+            '无需请求;「回退时一并还原文件」那一义被引擎拒收、改名为 restoreFiles)。本包在装配前拒:在场即拒,true / false 同判。' +
+            '处置:删掉这个键;要在回退会话时一并还原文件,改交 ' +
+            'rewind.restoreFiles: true(必须与 rewind.resumeAt 同交);只还原文件、不动会话,交 rewind.rewindFilesTo。错误文本只报键名,不回显值。');
+    }
     if (unknownKeys.length > 0) {
         const shown = unknownKeys.slice(0, MAX_UNKNOWN_KEYS_SHOWN).map(keyForDisplay).join(', ');
         const more = unknownKeys.length > MAX_UNKNOWN_KEYS_SHOWN ? ` 等共 ${unknownKeys.length} 个` : '';

package/dist/rewindWireCaps.d.ts

@@ -2,7 +2,6 @@ export interface SeamRewindSpec {
     resumeAt?: string;
     resumeAtMode?: 'at' | 'before';
     restoreFiles?: boolean;
-    rewindFiles?: boolean;
     rewindFilesTo?: string;
 }
 export type RewindMode = 'both' | 'conversation' | 'code';

package/dist/seam.d.ts

@@ -2,7 +2,7 @@ import type { ModelUsage, SDKMessage } from '@sema-agent/agent-types';
 import type { EngineTurnUsage } from './adapter/downstream/turnUsageToModelUsage.js';
 import type { RunCostReconcile } from './adapter/downstream/terminalToSdkResult.js';
 import type { WiringManifestAutoMode, WiringManifestModelGate, WiringManifestMcpEntryView, WiringManifestHookEntryView, WiringManifestLspSeamView, WiringManifestWriteProtectionView, WiringManifestAutoConsolidationView, WiringManifestReadDenyView, ContextUsageSectionView, PromptManifestSectionView, PromptManifestBlockView, PromptManifestToolView } from './adapter/downstream/eventToSdkMessage.js';
-import type { ToolRosterView, ToolRosterDeltaView } from './toolRoster.js';
+import type { ToolRosterView, ToolRosterDeltaView, WiringManifestHandsView } from './toolRoster.js';
 export interface AbortSignalLike {
     readonly aborted: boolean;
 }
@@ -162,6 +162,7 @@ export interface WiringManifestChromeEvent {
     writeProtection?: WiringManifestWriteProtectionView;
     autoConsolidation?: WiringManifestAutoConsolidationView;
     readDeny?: WiringManifestReadDenyView;
+    hands?: WiringManifestHandsView;
     eventId?: string;
 }
 export interface TextSegmentCommittedRow {

package/dist/seatContract.js

@@ -12,13 +12,13 @@ const isObject = (v) => typeof v === "object" && v !== null;
 const isAbsent = (v) => typeof v === "undefined";
 const optionalString = (v) => isAbsent(v) || typeof v === "string";
 const inTuple = (tuple, v) => tuple.includes(v);
-export const TOOL_PERMISSION_REQUEST_ID_DOMAINS = [
+export const TOOL_PERMISSION_REQUEST_ID_DOMAINS = Object.freeze([
     "live:",
     "durable:",
     "question:",
     "elicit:",
     "plan:",
-];
+]);
 export function toolPermissionRequestIdDomain(requestId) {
     if (typeof requestId !== "string")
         return undefined;

package/dist/toolResult.js

@@ -2,7 +2,8 @@ import { convertLeadingTabsToSpaces, getPatchFromContents } from './diff/patch.j
 import { markEngineWorkflowNotified, registerOutstandingBgTask, registerOutstandingWorkflowRun, } from './notifications.js';
 import { parseWorkflowPollEnvelope, projectWorkflowTaskOutput } from './workflow.js';
 import { asModelFallbackReason } from './engineErrorCodes.js';
-export const STRUCTURED_DETAIL_TYPES = new Set([
+import { frozenSet } from './frozenSet.js';
+export const STRUCTURED_DETAIL_TYPES = frozenSet([
     'edit',
     'create',
     'update',
@@ -58,13 +59,8 @@ export function structuredDetailType(structured) {
 const MAX_STRUCTURED_FIELD_CHARS = 1_000_000;
 const WF_TERMINAL_STATUSES = new Set([
     'completed',
-    'done',
     'failed',
-    'stopped',
-    'interrupted',
-    'error',
     'cancelled',
-    'canceled',
 ]);
 export const PROTOCOL_MARKERS = {
     bashHead: /^exit code: (-?\d+)(?: \(([^)\n]*)\))?\n(--- stdout ---\n)?/,

package/dist/toolRoster.d.ts

@@ -63,6 +63,22 @@ export type HandsMountedReading = {
     why: 'no-manifest' | 'no-roster' | 'roster-unreadable' | 'mount-condition-absent';
 };
 export declare function handsMountedFromManifest(manifest: unknown): HandsMountedReading;
+export interface WiringManifestHandsView {
+    mounted: boolean;
+    reason?: string;
+}
+export type HandsSeamReading = {
+    kind: 'not_reported';
+} | {
+    kind: 'mounted';
+} | {
+    kind: 'not_mounted';
+    reason?: string;
+};
+export declare function handsSeamReadingOf(view: {
+    readonly hands?: WiringManifestHandsView;
+} | null | undefined): HandsSeamReading;
+export declare function handsSeamDetail(reading: HandsSeamReading): string;
 export declare function handsMountedDetail(reading: HandsMountedReading): string;
 export declare function toolRosterNames(roster: ToolRosterView | undefined): readonly string[];
 export interface ToolShim {

package/dist/toolRoster.js

@@ -1,3 +1,5 @@
+import { displayUntrusted } from './displayUntrusted.js';
+import { HANDS_REASON_NO_EXECUTION_ENV, projectHandsSection } from './handsSeam.js';
 const str = (v) => typeof v === 'string' && v.length > 0 ? v : undefined;
 const strArr = (v) => Array.isArray(v) ? v.filter((x) => typeof x === 'string') : undefined;
 const obj = (v) => typeof v === 'object' && v !== null && !Array.isArray(v) ? v : undefined;
@@ -135,14 +137,51 @@ export function handsMountedFromManifest(manifest) {
     const rows = roster.entries.filter((e) => e.mountedBy === 'hands').length;
     return rows > 0 ? { kind: 'mounted', rows } : { kind: 'not-mounted' };
 }
-export function handsMountedDetail(reading) {
-    switch (reading.kind) {
+export function handsSeamReadingOf(view) {
+    const seam = typeof view === 'object' && view !== null ? projectHandsSection(view) : undefined;
+    if (seam === undefined)
+        return { kind: 'not_reported' };
+    if (seam.mounted)
+        return { kind: 'mounted' };
+    return seam.reason !== undefined ? { kind: 'not_mounted', reason: seam.reason } : { kind: 'not_mounted' };
+}
+const HANDS_NONE_STEM = 'this leg of the run was assembled with NO built-in file-and-shell tools';
+const HANDS_NONE_TAIL = "so on this leg the model had no tool of the engine's own for editing files or running commands (tools mounted by other conditions, such as external servers, and sub-runs delegated to other legs are not covered by this reading)";
+const HANDS_REASON_DISPLAY_MAX = 64;
+const HANDS_NOT_REPORTED_SENTENCE = 'whether this leg has built-in file-and-shell tools is not stated here — the engine did not report its hands seam (older engines and servers, and the static half of a manifest, never do); the tool roster may still answer it';
+export function handsSeamDetail(reading) {
+    const kind = typeof reading === 'object' && reading !== null ? reading.kind : undefined;
+    switch (kind) {
         case 'mounted':
-            return `this run was assembled with file-and-shell tools mounted (${reading.rows} of them)`;
+            return 'this leg of the run was assembled with its built-in file tools mounted — the engine says so; whether a shell is reachable is answered by the tool roster, not by this statement';
+        case 'not_mounted': {
+            const raw = reading.reason;
+            const reason = typeof raw === 'string' && raw.length > 0 ? raw : undefined;
+            const why = reason === undefined
+                ? 'the engine states it mounted no hands on this leg (it gave no reason)'
+                : reason === HANDS_REASON_NO_EXECUTION_ENV
+                    ? 'the engine states it mounted no hands on this leg because no execution environment was supplied'
+                    : `the engine states it mounted no hands on this leg (reason: ${displayUntrusted(reason, { max: HANDS_REASON_DISPLAY_MAX })}, a word this build does not know)`;
+            return `${HANDS_NONE_STEM} — ${why}, ${HANDS_NONE_TAIL}`;
+        }
+        default:
+            return HANDS_NOT_REPORTED_SENTENCE;
+    }
+}
+export function handsMountedDetail(reading) {
+    const r = reading;
+    const kind = typeof r === 'object' && r !== null ? r.kind : undefined;
+    switch (kind) {
+        case 'mounted': {
+            const rows = r.rows;
+            if (typeof rows === 'number' && Number.isInteger(rows) && rows > 0)
+                return `this run was assembled with file-and-shell tools mounted (${rows} of them)`;
+            return HANDS_NOT_REPORTED_SENTENCE;
+        }
         case 'not-mounted':
-            return 'this leg of the run was assembled with NO built-in file-and-shell tools — the engine reports a roster and not one row was mounted by that condition, so on this leg the model had no tool of the engine\'s own for editing files or running commands (tools mounted by other conditions, such as external servers, and sub-runs delegated to other legs are not covered by this reading)';
+            return `${HANDS_NONE_STEM} — the engine reports a roster and not one row was mounted by that condition, ${HANDS_NONE_TAIL}`;
         case 'unknown':
-            switch (reading.why) {
+            switch (r.why) {
                 case 'no-manifest':
                     return 'whether this run has file-and-shell tools is unknown — no assembly manifest was observed for it';
                 case 'no-roster':
@@ -152,7 +191,9 @@ export function handsMountedDetail(reading) {
                 case 'mount-condition-absent':
                     return 'whether this run has file-and-shell tools is unknown — this engine does not report which condition mounted each tool, so an empty count here would be a fact about the reader, not about the run';
             }
+            return HANDS_NOT_REPORTED_SENTENCE;
     }
+    return HANDS_NOT_REPORTED_SENTENCE;
 }
 export function toolRosterNames(roster) {
     return roster?.entries.map((e) => e.name) ?? [];

package/dist/wireErrorTriage.js

@@ -45,10 +45,6 @@ export function isPreStreamDrainingReject(err) {
     const e = err;
     return typeof e?.status === 'number' && e.status === 503 && e.errorCode === DRAINING_ERROR_CODE;
 }
-const RESUME_AT_TEXT_COMPAT = [
-    { status: 404, marker: `(${RESUME_AT_ERROR_CODE_PREFIX}unknown_event)` },
-    { status: 422, marker: `(${RESUME_AT_ERROR_CODE_PREFIX}no_session)` },
-];
 export function effectiveWireErrorCode(err) {
     if (typeof err !== 'object' || err === null)
         return undefined;
@@ -75,14 +71,8 @@ export function corruptStoredRowContent(where) {
     return `The engine could not read a stored record this session needs in order to continue. The unreadable row is ${capForDisplay(where, 200)}; whoever operates this engine has to repair or remove that row before this session can continue.`;
 }
 export function isResumeAtRejection(err) {
-    const e = err;
     const code = effectiveWireErrorCode(err);
-    if (code !== undefined && code.startsWith(RESUME_AT_ERROR_CODE_PREFIX))
-        return true;
-    const marker = RESUME_AT_TEXT_COMPAT.find((c) => c.status === e?.status)?.marker;
-    if (marker === undefined)
-        return false;
-    return [e?.message, e?.errorMessage].some((t) => typeof t === 'string' && t.endsWith(marker));
+    return code !== undefined && code.startsWith(RESUME_AT_ERROR_CODE_PREFIX);
 }
 export function drainingRetryDelayMs(err, attempt, opts) {
     const ra = err?.retryAfterMs;

package/dist/workflowClient.js

@@ -240,7 +240,8 @@ function synthPhaseStatus(runStatus, agents) {
 }
 export function projectWorkflowRun(run) {
     const parks = readWorkflowParks(run);
-    const agents = (run.agents ?? []).map((r, i) => projectAgent(r, i));
+    const agentsKnown = Array.isArray(run.agents);
+    const agents = (agentsKnown ? run.agents : []).map((r, i) => projectAgent(r, i));
     const phases = projectPhases(run, agents);
     const validTokens = (v) => typeof v === 'number' && Number.isInteger(v) && v >= 0 ? v : undefined;
     const ownTokens = validTokens(run.stats?.tokens);
@@ -265,7 +266,7 @@ export function projectWorkflowRun(run) {
         ...(parks !== undefined ? { parks } : {}),
         ...(readWorkflowResumeAdmissionIncomplete(run) ? { resumeAdmissionIncomplete: true } : {}),
         script: '',
-        agentCount: agents.length,
+        ...(agentsKnown ? { agentCount: agents.length } : {}),
         ...(totalTokens !== undefined ? { totalTokens } : {}),
         phases,
     };
@@ -814,7 +815,7 @@ export function createLiveWorkflowSource(config) {
             code = null;
             lastError = null;
             if (engineWireDebugEnabled()) {
-                hostLog('debug', `[sema][workflow][perf] get ${Date.now() - t0}ms first=${first} agents=${current.agentCount} phases=${current.phases.length}`);
+                hostLog('debug', `[sema][workflow][perf] get ${Date.now() - t0}ms first=${first} agents=${current.agentCount ?? '?'} phases=${current.phases.length}`);
             }
             first = false;
             notify();

package/dist/workflowMonitor.d.ts

@@ -49,7 +49,7 @@ export interface WorkflowRunState {
     scriptPath?: string;
     status: 'running' | 'done' | 'failed' | 'stopped' | 'paused' | 'parked' | 'unknown';
     cloud?: boolean;
-    agentCount: number;
+    agentCount?: number;
     totalTokens?: number;
     phases: WorkflowPhase[];
     parks?: readonly WorkflowParkRowView[];