@jingyi0605/codingns 0.6.1 → 0.7.0

package/dist/server/modules/sessions/session-history-service.js

@@ -6,7 +6,6 @@ import { createId } from "../../shared/utils/id.js";
 import { logPerformance } from "../../shared/utils/perf-log.js";
 import { isTerminalDebugEnabled, logTerminalDebug, terminalDebugNowMs } from "../../shared/utils/terminal-debug-log.js";
 import { nowIso } from "../../shared/utils/time.js";
-import { isCommandAvailable } from "../../shared/utils/command-availability.js";
 import { inspectSessionActivity } from "./session-activity-inspector.js";
 import { SessionActivityAuthorityService } from "./session-activity-authority-service.js";
 import { mapSessionProviderError } from "./session-provider-error-mapper.js";
@@ -17,6 +16,8 @@ import { CodexModelOptionsService, createFallbackCodexModelOptions, enrichCodexC
 import { OpenCodeModelOptionsService, createFallbackOpenCodeModelOptions, enrichOpenCodeCapabilities } from "../provider/opencode-model-options.js";
 import { getSharedProviderDiscoveryHelperClient } from "../provider/provider-discovery-helper-client.js";
 import { discoverWorkspaceSessionsInRuntime } from "../provider/provider-discovery-runtime.js";
+import { applyProviderDisabledState, createProviderCapabilityBlockedError } from "../provider/provider-disabled.js";
+import { ProviderRuntimeStateService } from "../provider/provider-runtime-state-service.js";
 import { createTaskManager } from "../tasks/task-manager.js";
 import { HOST_TASK_TYPES } from "../tasks/task-types.js";
 import { CodexAppServerHelperClient } from "./codex-app-server-helper-client.js";
@@ -71,14 +72,14 @@ export class SessionHistoryService {
     claudeCodeHomeDir;
     codexModelOptionsService;
     openCodeModelOptionsService;
-    providerCliCommandPaths;
-    providerCliAvailability;
     parallelSessionGroupRepository;
     parallelSessionMemberRepository;
     sessionIsolatedWorkspaceRepository;
     providerDiscoveryHelperClient = getSharedProviderDiscoveryHelperClient();
     providerSessionDiscoveryConfig;
+    providerRuntimeStateService;
     sessionProviderConfigService;
+    providerControlRepository;
     taskManager;
     workspaceDiscoveryStatuses = new Map();
     workspaceStateRefreshStatuses = new Map();
@@ -88,7 +89,7 @@ export class SessionHistoryService {
     sessionDeletedObservers = new Set();
     workspaceSessionRelations = new Map();
     workspaceStateRefreshTaskSequence = 0;
-    constructor(db, workspaceRepository, sessionBindingRepository, sessionChangedFileService, sessionIndexRepository, sessionMessageAttachmentService, sessionStateRepository, sessionStatusSnapshotRepository, config, sessionActivityAuthorityService = new SessionActivityAuthorityService(), sessionMessageOriginRepository = null, sessionForkRepository = null, adapterOverrides = {}, taskManager = createTaskManager(), parallelSessionGroupRepository = null, parallelSessionMemberRepository = null, sessionIsolatedWorkspaceRepository = null, sessionProviderConfigService = null) {
+    constructor(db, workspaceRepository, sessionBindingRepository, sessionChangedFileService, sessionIndexRepository, sessionMessageAttachmentService, sessionStateRepository, sessionStatusSnapshotRepository, config, sessionActivityAuthorityService = new SessionActivityAuthorityService(), sessionMessageOriginRepository = null, sessionForkRepository = null, adapterOverrides = {}, taskManager = createTaskManager(), parallelSessionGroupRepository = null, parallelSessionMemberRepository = null, sessionIsolatedWorkspaceRepository = null, sessionProviderConfigService = null, providerControlRepository = null, providerRuntimeStateService = null) {
         this.db = db;
         this.workspaceRepository = workspaceRepository;
         this.sessionBindingRepository = sessionBindingRepository;
@@ -107,16 +108,16 @@ export class SessionHistoryService {
         this.parallelSessionMemberRepository = parallelSessionMemberRepository;
         this.sessionIsolatedWorkspaceRepository = sessionIsolatedWorkspaceRepository;
         this.sessionProviderConfigService = sessionProviderConfigService;
-        this.claudeCodeHomeDir = config.claudeCodeHomeDir;
-        this.providerCliCommandPaths = {
-            "claude-code": process.platform === "win32" ? "claude.cmd" : "claude",
-            "legna-code": config.legnaCodeCliPath,
-            codex: config.codexCliPath,
-            gemini: config.geminiCliPath,
-            kimi: config.kimiCliPath
+        this.providerRuntimeStateService = providerRuntimeStateService
+            ?? new ProviderRuntimeStateService(config);
+        this.providerControlRepository = providerControlRepository ?? {
+            get: (providerId) => ({
+                providerId: providerId.trim(),
+                enabled: true,
+                updatedAt: ""
+            })
         };
-        // CLI 是否可用只在 Host 启动时探测一次；后续统一读缓存，更新 CLI 后重启 Host 生效。
-        this.providerCliAvailability = buildProviderCliAvailabilitySnapshot(this.providerCliCommandPaths);
+        this.claudeCodeHomeDir = config.claudeCodeHomeDir;
         this.providerSessionDiscoveryConfig = {
             claudeCodeHomeDir: config.claudeCodeHomeDir,
             legnaCodeHomeDir: config.legnaCodeHomeDir,
@@ -208,7 +209,7 @@ export class SessionHistoryService {
                 executionLane: "helper_process",
                 concurrency: WORKSPACE_DISCOVERY_SCAN_CONCURRENCY,
                 helperProcessHandler: "session.workspace_discovery",
-                run: async ({ config, workspacePath, knownSessions }, context) => await discoverWorkspaceSessionsInRuntime(config, workspacePath, knownSessions, context.signal)
+                run: async ({ config, workspacePath, knownSessions, enabledProviders }, context) => await discoverWorkspaceSessionsInRuntime(config, workspacePath, knownSessions, enabledProviders, context.signal)
             });
         }
         if (!this.taskManager.has(HOST_TASK_TYPES.providerCapabilityRefresh)) {
@@ -453,11 +454,11 @@ export class SessionHistoryService {
             .listByWorkspace(workspaceId, userId)
             .filter((item) => !this.isPendingSessionAlias(item));
         const projectedItems = this.listProjectedIsolatedWorkspaceSessions(workspaceId, userId);
-        return this.enrichSessionItems(workspaceId, sortSessionListItemsByRecentActivity(mergeSessionListItemsBySessionId([...directItems, ...projectedItems])));
+        return this.filterDisabledProviderSessions(this.enrichSessionItems(workspaceId, sortSessionListItemsByRecentActivity(mergeSessionListItemsBySessionId([...directItems, ...projectedItems]))));
     }
     getProviderCapabilitiesSnapshot(provider) {
         try {
-            return this.resolveProviderCapabilitiesImmediate(this.applyProviderCliAvailability(this.capabilityService.getProviderCapabilities(provider)), null);
+            return this.applyProviderEnabledState(this.resolveProviderCapabilitiesImmediate(this.applyProviderCliAvailability(this.capabilityService.getProviderCapabilities(provider)), null));
         }
         catch (error) {
             throw mapSessionProviderError(error);
@@ -474,10 +475,10 @@ export class SessionHistoryService {
                     refreshedAt: Date.now(),
                     value: refreshed
                 });
-                return refreshed;
+                return this.applyProviderEnabledState(refreshed);
             }
             this.scheduleProviderCapabilityRefresh(baseCapabilities, workspacePath);
-            return this.resolveProviderCapabilitiesImmediate(baseCapabilities, workspacePath);
+            return this.applyProviderEnabledState(this.resolveProviderCapabilitiesImmediate(baseCapabilities, workspacePath));
         }
         catch (error) {
             throw mapSessionProviderError(error);
@@ -499,11 +500,11 @@ export class SessionHistoryService {
                         refreshedAt: Date.now(),
                         value: refreshed
                     });
-                    return refreshed;
+                    return this.applyProviderEnabledState(refreshed);
                 });
             }
             this.scheduleProviderCapabilityRefresh(normalizedCapabilities, workspacePath);
-            return this.resolveProviderCapabilitiesImmediate(normalizedCapabilities, workspacePath);
+            return this.applyProviderEnabledState(this.resolveProviderCapabilitiesImmediate(normalizedCapabilities, workspacePath));
         })
             .catch((error) => {
             throw mapSessionProviderError(error);
@@ -531,6 +532,9 @@ export class SessionHistoryService {
         return applyImmediateModelOptionFallbacks(claudeEnriched, this.codexModelOptionsService.peekSnapshot(), this.openCodeModelOptionsService.peekSnapshot(workspacePath));
     }
     scheduleProviderCapabilityRefresh(capabilities, workspacePath) {
+        if (!this.isProviderEnabled(capabilities.provider)) {
+            return;
+        }
         const cacheKey = buildProviderCapabilityCacheKey(capabilities.provider, workspacePath);
         const cached = this.providerCapabilityCache.get(cacheKey);
         if (cached &&
@@ -563,7 +567,7 @@ export class SessionHistoryService {
         if (!isProviderCliBacked(capabilities.provider)) {
             return capabilities;
         }
-        if (this.providerCliAvailability[capabilities.provider]) {
+        if (this.providerRuntimeStateService.isProviderCliAvailable(capabilities.provider)) {
             return capabilities;
         }
         const limitation = buildProviderCliUnavailableMessage(capabilities.provider);
@@ -582,17 +586,31 @@ export class SessionHistoryService {
             limitations
         };
     }
+    applyProviderEnabledState(capabilities) {
+        if (this.isProviderEnabled(capabilities.provider)) {
+            return capabilities;
+        }
+        return applyProviderDisabledState(capabilities);
+    }
+    isProviderEnabled(provider) {
+        return this.providerControlRepository.get(provider.trim()).enabled;
+    }
+    filterDisabledProviderSessions(items) {
+        return items.filter((item) => this.isProviderEnabled(item.provider));
+    }
     assertProviderCapabilityEnabled(provider, capability, fallbackDetail) {
         const capabilities = this.getProviderCapabilitiesSnapshot(provider);
         if (capabilities[capability]) {
             return;
         }
-        throw new AppError({
-            statusCode: 409,
-            errorCode: "PROVIDER_UNAVAILABLE",
-            detail: capabilities.limitations[0] ?? fallbackDetail,
-            field: "provider"
-        });
+        throw createProviderCapabilityBlockedError(capabilities, "provider", fallbackDetail);
+    }
+    assertProviderSendEnabled(provider, field, fallbackDetail) {
+        const capabilities = this.getProviderCapabilitiesSnapshot(provider);
+        if (capabilities.canSendMessage) {
+            return;
+        }
+        throw createProviderCapabilityBlockedError(capabilities, field, fallbackDetail);
     }
     async getSessionContextUsage(sessionId) {
         const binding = this.getBindingOrThrow(sessionId);
@@ -629,6 +647,7 @@ export class SessionHistoryService {
         }
     }
     async startSession(input) {
+        this.assertProviderCapabilityEnabled(input.provider, "canStartSession", "当前 provider 不支持创建会话");
         if (SESSION_START_DEFERRED_PROVIDERS.has(input.provider)) {
             throw new AppError({
                 statusCode: 409,
@@ -1008,6 +1027,7 @@ export class SessionHistoryService {
     }
     async sendMessage(sessionId, content, clientRequestId, permissionMode = null) {
         const binding = this.getBindingOrThrow(sessionId);
+        this.assertProviderSendEnabled(binding.provider, "sessionId", "当前 provider 不支持继续发送消息");
         const result = await this.sessionSyncService
             .sendMessage(binding.provider, binding.providerSessionId, binding.rawStoreRef, content, clientRequestId, permissionMode)
             .catch((error) => {
@@ -1383,14 +1403,19 @@ export class SessionHistoryService {
         try {
             const discoverStartedAt = Date.now();
             const existingWorkspaceSessions = this.sessionIndexRepository.listByWorkspace(workspaceId, userId);
-            const knownSessions = this.buildKnownSessionSummaries(existingWorkspaceSessions, workspace.path);
+            const enabledProviders = this.providerRegistry
+                .list()
+                .map((adapter) => adapter.providerId)
+                .filter((providerId) => this.isProviderEnabled(providerId));
+            const knownSessions = this.buildKnownSessionSummaries(existingWorkspaceSessions.filter((session) => enabledProviders.includes(session.provider)), workspace.path);
             const discoveryHandle = this.taskManager.enqueue(HOST_TASK_TYPES.workspaceDiscoveryScan, {
                 key: workspaceId,
                 source: "session_history.workspace_discovery.scan",
                 input: {
                     config: this.providerSessionDiscoveryConfig,
                     workspacePath: workspace.path,
-                    knownSessions
+                    knownSessions,
+                    enabledProviders
                 }
             });
             const discovery = await awaitTaskHandleWithSignal(discoveryHandle, signal).catch((error) => {
@@ -1532,12 +1557,15 @@ export class SessionHistoryService {
                         annotationSourceText: relation?.annotationSourceText
                             ?? persistedSession.existingIndex?.annotationSourceText
                             ?? null,
-                        isSubagent: relation?.isSubagent
-                            ?? persistedSession.existingIndex?.isSubagent
-                            ?? false,
-                        subagentLabel: relation?.subagentLabel
-                            ?? persistedSession.existingIndex?.subagentLabel
-                            ?? null,
+                        isSubagent: resolvePersistedSubagentState({
+                            discoveredIsSubagent: relation?.isSubagent,
+                            existingIsSubagent: persistedSession.existingIndex?.isSubagent
+                        }),
+                        subagentLabel: resolvePersistedSubagentLabel({
+                            discoveredIsSubagent: relation?.isSubagent,
+                            discoveredSubagentLabel: relation?.subagentLabel ?? null,
+                            existingSubagentLabel: persistedSession.existingIndex?.subagentLabel ?? null
+                        }),
                         title: resolvePersistedSessionTitle(persistedSession.session.provider, persistedSession.session.title, persistedSession.existingIndex?.title ?? null, resolvedParentTitle),
                         messageCount: persistedSession.session.messageCount,
                         isArchived: resolveDiscoveredArchiveState(persistedSession.session.provider, persistedSession.existingIndex?.isArchived ?? false, persistedSession.session.isArchived),
@@ -1830,6 +1858,7 @@ export class SessionHistoryService {
             if (!sessionId) {
                 continue;
             }
+            const existingIndex = this.sessionIndexRepository.findIndexRecordBySessionId(sessionId);
             const parentSessionId = session.parentProviderSessionId
                 ? discoveredSessionIds.get(buildProviderSessionKey(session.provider, session.parentProviderSessionId)) ??
                     this.sessionBindingRepository.findByProviderSession(session.provider, session.parentProviderSessionId)?.sessionId ??
@@ -1837,14 +1866,18 @@ export class SessionHistoryService {
                 : this.resolvePersistedParentSessionId(sessionId);
             relationMap.set(sessionId, {
                 parentSessionId,
-                sessionKind: this.sessionIndexRepository.findIndexRecordBySessionId(sessionId)?.sessionKind ?? "default",
-                annotationSourceMessageId: this.sessionIndexRepository.findIndexRecordBySessionId(sessionId)?.annotationSourceMessageId ?? null,
-                annotationSourceText: this.sessionIndexRepository.findIndexRecordBySessionId(sessionId)?.annotationSourceText ?? null,
-                isSubagent: session.isSubagent === true
-                    || this.sessionIndexRepository.findIndexRecordBySessionId(sessionId)?.isSubagent === true,
-                subagentLabel: session.subagentLabel?.trim()
-                    || this.sessionIndexRepository.findIndexRecordBySessionId(sessionId)?.subagentLabel
-                    || null
+                sessionKind: existingIndex?.sessionKind ?? "default",
+                annotationSourceMessageId: existingIndex?.annotationSourceMessageId ?? null,
+                annotationSourceText: existingIndex?.annotationSourceText ?? null,
+                isSubagent: resolvePersistedSubagentState({
+                    discoveredIsSubagent: session.isSubagent,
+                    existingIsSubagent: existingIndex?.isSubagent
+                }),
+                subagentLabel: resolvePersistedSubagentLabel({
+                    discoveredIsSubagent: session.isSubagent,
+                    discoveredSubagentLabel: session.subagentLabel ?? null,
+                    existingSubagentLabel: existingIndex?.subagentLabel ?? null
+                })
             });
         }
         return relationMap;
@@ -1976,8 +2009,13 @@ export class SessionHistoryService {
             .listBySourceWorkspaceId(workspaceId)
             .filter((record) => record.lifecycleStatus === "active"
             || record.lifecycleStatus === "removing")
-            .map((record) => this.sessionIndexRepository.findBySessionId(record.ownerSessionId, userId))
-            .filter((item) => Boolean(item))
+            .flatMap((record) => {
+            const isolatedWorkspaceItems = this.sessionIndexRepository.listByWorkspace(record.workspaceId, userId);
+            if (isolatedWorkspaceItems.length === 0) {
+                return [];
+            }
+            return filterProjectedIsolatedWorkspaceSessionTree(isolatedWorkspaceItems, record.ownerSessionId);
+        })
             .filter((item) => !this.isPendingSessionAlias(item));
     }
     async pullSessionHistory(sessionId, cursor, limit, deliveredMessages, onEnvelope, envelopeType, isClosed = () => false) {
@@ -2668,15 +2706,15 @@ export class SessionHistoryService {
                 ?? targetIndex?.annotationSourceText
                 ?? sourceIndex?.annotationSourceText
                 ?? null,
-            isSubagent: Boolean(targetRelation?.isSubagent
-                || sourceRelation?.isSubagent
-                || targetIndex?.isSubagent
-                || sourceIndex?.isSubagent),
-            subagentLabel: targetRelation?.subagentLabel
-                ?? sourceRelation?.subagentLabel
-                ?? targetIndex?.subagentLabel
-                ?? sourceIndex?.subagentLabel
-                ?? null
+            isSubagent: resolvePersistedSubagentState({
+                discoveredIsSubagent: targetRelation?.isSubagent ?? sourceRelation?.isSubagent,
+                existingIsSubagent: targetIndex?.isSubagent ?? sourceIndex?.isSubagent
+            }),
+            subagentLabel: resolvePersistedSubagentLabel({
+                discoveredIsSubagent: targetRelation?.isSubagent ?? sourceRelation?.isSubagent,
+                discoveredSubagentLabel: targetRelation?.subagentLabel ?? sourceRelation?.subagentLabel ?? null,
+                existingSubagentLabel: targetIndex?.subagentLabel ?? sourceIndex?.subagentLabel ?? null
+            })
         });
         for (const relation of relationMap.values()) {
             if (relation.parentSessionId === sourceSessionId) {
@@ -2725,6 +2763,12 @@ export class SessionHistoryService {
         return Number(row?.count ?? 0);
     }
     detachSessionRelationsBeforeDelete(sessionId) {
+        const controlSessionIds = this.db
+            .prepare(`SELECT id
+         FROM butler_control_sessions
+         WHERE session_id = ?`)
+            .all(sessionId)
+            .map((row) => String(row.id));
         this.db
             .prepare(`UPDATE session_indices
          SET parent_session_id = NULL
@@ -2735,6 +2779,47 @@ export class SessionHistoryService {
          WHERE parent_session_id = ?
             OR fork_source_session_id = ?`)
             .run(sessionId, sessionId);
+        if (controlSessionIds.length > 0) {
+            const controlSessionPlaceholders = controlSessionIds.map(() => "?").join(", ");
+            this.db
+                .prepare(`UPDATE channel_threads
+           SET control_session_id = NULL,
+               session_id = NULL
+           WHERE session_id = ?
+              OR control_session_id IN (${controlSessionPlaceholders})`)
+                .run(sessionId, ...controlSessionIds);
+            this.db
+                .prepare(`UPDATE channel_inbound_events
+           SET control_session_id = NULL,
+               session_id = NULL
+           WHERE session_id = ?
+              OR control_session_id IN (${controlSessionPlaceholders})`)
+                .run(sessionId, ...controlSessionIds);
+            this.db
+                .prepare(`UPDATE channel_deliveries
+           SET control_session_id = NULL,
+               session_id = NULL
+           WHERE session_id = ?
+              OR control_session_id IN (${controlSessionPlaceholders})`)
+                .run(sessionId, ...controlSessionIds);
+        }
+        else {
+            this.db
+                .prepare(`UPDATE channel_threads
+           SET session_id = NULL
+           WHERE session_id = ?`)
+                .run(sessionId);
+            this.db
+                .prepare(`UPDATE channel_inbound_events
+           SET session_id = NULL
+           WHERE session_id = ?`)
+                .run(sessionId);
+            this.db
+                .prepare(`UPDATE channel_deliveries
+           SET session_id = NULL
+           WHERE session_id = ?`)
+                .run(sessionId);
+        }
         this.db
             .prepare("DELETE FROM butler_control_sessions WHERE session_id = ?")
             .run(sessionId);
@@ -2966,6 +3051,42 @@ export class SessionHistoryService {
         });
     }
 }
+function filterProjectedIsolatedWorkspaceSessionTree(items, ownerSessionId) {
+    const normalizedOwnerSessionId = ownerSessionId.trim();
+    if (!normalizedOwnerSessionId) {
+        return [];
+    }
+    const itemBySessionId = new Map(items.map((item) => [item.sessionId, item]));
+    const ownerItem = itemBySessionId.get(normalizedOwnerSessionId);
+    if (!ownerItem) {
+        return [];
+    }
+    const childSessionIdsByParentId = new Map();
+    for (const item of items) {
+        const parentSessionId = item.parentSessionId?.trim();
+        if (!parentSessionId) {
+            continue;
+        }
+        const sessionIds = childSessionIdsByParentId.get(parentSessionId) ?? [];
+        sessionIds.push(item.sessionId);
+        childSessionIdsByParentId.set(parentSessionId, sessionIds);
+    }
+    const projectedSessionIds = new Set();
+    const queue = [normalizedOwnerSessionId];
+    while (queue.length > 0) {
+        const currentSessionId = queue.shift();
+        if (!currentSessionId || projectedSessionIds.has(currentSessionId)) {
+            continue;
+        }
+        projectedSessionIds.add(currentSessionId);
+        for (const childSessionId of childSessionIdsByParentId.get(currentSessionId) ?? []) {
+            if (!projectedSessionIds.has(childSessionId)) {
+                queue.push(childSessionId);
+            }
+        }
+    }
+    return items.filter((item) => projectedSessionIds.has(item.sessionId));
+}
 function isProviderCliBacked(provider) {
     return provider === "claude-code"
         || provider === "legna-code"
@@ -2973,12 +3094,6 @@ function isProviderCliBacked(provider) {
         || provider === "gemini"
         || provider === "kimi";
 }
-function buildProviderCliAvailabilitySnapshot(commandPaths) {
-    return Object.freeze(Object.fromEntries(Object.entries(commandPaths).map(([provider, commandPath]) => [
-        provider,
-        isCommandAvailable(commandPath)
-    ])));
-}
 function buildProviderCliUnavailableMessage(provider) {
     switch (provider) {
         case "claude-code":
@@ -3220,8 +3335,13 @@ function mergeSessionIndexRecord(input) {
         sessionKind: input.target?.sessionKind ?? input.source?.sessionKind ?? "default",
         annotationSourceMessageId: input.target?.annotationSourceMessageId ?? input.source?.annotationSourceMessageId ?? null,
         annotationSourceText: input.target?.annotationSourceText ?? input.source?.annotationSourceText ?? null,
-        isSubagent: Boolean(input.target?.isSubagent || input.source?.isSubagent),
-        subagentLabel: input.target?.subagentLabel ?? input.source?.subagentLabel ?? null,
+        isSubagent: resolvePersistedSubagentState({
+            discoveredIsSubagent: input.target?.isSubagent ?? input.source?.isSubagent
+        }),
+        subagentLabel: resolvePersistedSubagentLabel({
+            discoveredIsSubagent: input.target?.isSubagent ?? input.source?.isSubagent,
+            discoveredSubagentLabel: input.target?.subagentLabel ?? input.source?.subagentLabel ?? null
+        }),
         title: pickPreferredSessionTitle(input.target?.title ?? null, input.source?.title ?? null),
         messageCount: Math.max(input.target?.messageCount ?? 0, input.source?.messageCount ?? 0),
         isArchived: mergePersistedArchiveState(input.provider, input.target?.isArchived, input.source?.isArchived),
@@ -3238,6 +3358,22 @@ function mergePersistedArchiveState(provider, targetArchived, sourceArchived) {
     }
     return targetArchived ?? sourceArchived ?? false;
 }
+function resolvePersistedSubagentState(input) {
+    if (typeof input.discoveredIsSubagent === "boolean") {
+        return input.discoveredIsSubagent;
+    }
+    return input.existingIsSubagent === true;
+}
+function resolvePersistedSubagentLabel(input) {
+    if (input.discoveredIsSubagent === false) {
+        return null;
+    }
+    const discoveredSubagentLabel = input.discoveredSubagentLabel?.trim() || null;
+    if (discoveredSubagentLabel) {
+        return discoveredSubagentLabel;
+    }
+    return input.existingSubagentLabel ?? null;
+}
 function mergeSessionStatusSnapshot(input) {
     if (!input.target && !input.source) {
         return null;