Function reloadIfSafe

desktop/runtime/settings-refresh.ts:109–155

(
    sessionPath: string,
    options: { useMutationLock?: boolean | undefined } = {},
  )

  }

  async function reloadIfSafe(
    sessionPath: string,
    options: { useMutationLock?: boolean | undefined } = {},
  ): Promise<boolean> {
    const runtimeKey = getPersistedSessionPath(sessionPath)
    if (!(runtimeKey && staleGenerations.has(runtimeKey))) {
      return false
    }

    if (options.useMutationLock ?? true) {
      return await withRuntimeMutationLock(runtimeKey, () =>
        reloadIfSafe(runtimeKey, { useMutationLock: false }),
      )
    }

    const runtimePromise = getCachedRuntimeForSessionPath(runtimeKey)
    if (!runtimePromise) {
      staleGenerations.delete(runtimeKey)
      return false
    }

    const runtime = await runtimePromise
    try {
      const { reloaded, reloadedGeneration } = await reloadRuntimeUntilStable({
        isRuntimeBusy: isRuntimeBusyOption,
        reloadRuntimeSettings,
        runtime,
        runtimeKey,
        staleGenerations,
      })

      if (reloaded) {
        await publishReloadedComposer({
          buildComposerState,
          publishComposerUpdate,
          reloadedGeneration,
          runtime,
          runtimeKey,
          staleGenerations,
        })
      }
      return reloaded
    } catch {
      // Keep the stale mark; the next safe point retries silently.
      return false
    }
  }

  function markStale(sessionPath: string | null | undefined) {
    const runtimeKey = getPersistedSessionPath(sessionPath ?? null)